Passer au contenu
MSM

Installation

Choisissez l'option qui correspond à votre hôte. Chaque chemin mène au même panneau.

Opérationnel en quelques minutes

Choisissez votre machine et collez les commandes. L'option Avancé propose toutes les autres méthodes d'exécution du panneau, avec des commandes réécrites pour votre propre dossier et adresse.

  1. 1

    Exécutez l'installeur

    Fonctionne sur toute machine Linux avec un OS 64 bits, d'un VPS à un Raspberry Pi 4 ou 5. Il installe Docker s'il est manquant, configure le panneau dans /opt/msm et le démarre. Exécutez-le à nouveau plus tard pour mettre à jour.

    curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash
  2. 2

    Ouvrez le panneau

    L'installeur affiche l'adresse et un code PIN de configuration unique. Ouvrez l'adresse dans un navigateur, entrez le code PIN et créez votre compte administrateur.

    http://your-server-ip:25564
  1. 1

    Installez Docker Desktop, Node.js, Git et pnpm

    Une ligne chacun dans PowerShell. Lancez Docker Desktop une fois installé et laissez-le tourner.

    winget install Docker.DockerDesktop
    winget install OpenJS.NodeJS.LTS
    winget install Git.Git
    winget install pnpm.pnpm
  2. 2

    Récupérez le panneau et lancez-le

    Ouvrez un nouveau terminal pour qu'il trouve les outils que vous venez d'installer.

    git clone https://github.com/anefzaoui/minecraft-server-manager.git
    cd minecraft-server-manager
    pnpm install
    pnpm start
  3. 3

    Ouvrez le panneau

    La première exécution vous guide à travers une vérification du système, votre fuseau horaire et la création du compte administrateur.

    http://localhost:25564
  1. 1

    Installez Docker Desktop, Node.js, Git et pnpm

    Avec Homebrew. Lancez Docker Desktop une fois installé et laissez-le tourner.

    brew install --cask docker-desktop
    brew install node git pnpm
  2. 2

    Récupérez le panneau et lancez-le

    L'étape d'installation compile également le panneau. Il n'y a rien à compiler.

    git clone https://github.com/anefzaoui/minecraft-server-manager.git
    cd minecraft-server-manager
    pnpm install
    pnpm start
  3. 3

    Ouvrez le panneau

    La première exécution vous guide à travers une vérification du système, votre fuseau horaire et la création du compte administrateur.

    http://localhost:25564

Remplissez les deux champs et chaque commande ci-dessous se réécrit pour votre machine.

  1. 1

    Créez le dossier de données

    Un seul dossier contient tout ce qui appartient au panneau.

    mkdir -p {{dataDir}}
  2. 2

    Téléchargez le fichier compose et pointez-le vers ce dossier

    DATA_DIR_HOST doit être le chemin absolu sur l'hôte, car Docker le monte du point de vue de l'hôte.

    curl -fsSLO https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/docker-compose.yml
    echo "DATA_DIR_HOST={{dataDir}}" > .env
  3. 3

    Démarrez le panneau

    L'image est multi-architecture (amd64 et arm64) et se met à jour à chaque version.

    docker compose up -d
  4. Puis ouvrez le panneau

    http://{{host}}:25564

    La première exécution vous guide à travers une vérification du système, votre fuseau horaire et la création du compte administrateur.

  1. 1

    Créez le dossier de données sur l'hôte

    Même règle pour le dossier : chemin absolu, sur la machine qui exécute Docker.

    mkdir -p {{dataDir}}
  2. 2

    Ajoutez une stack à partir du fichier compose

    Collez le contenu du fichier compose dans une nouvelle stack. Le fichier brut est ici :

    https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/docker-compose.yml
  3. 3

    Définissez la variable d'environnement et déployez

    Ajoutez-la dans la section environnement de la stack, puis déployez.

    DATA_DIR_HOST={{dataDir}}
  4. Puis ouvrez le panneau

    http://{{host}}:25564

    La première exécution vous guide à travers une vérification du système, votre fuseau horaire et la création du compte administrateur.

  1. 1

    Vérifiez les prérequis

    Node.js 24 ou plus récent, pnpm, et Docker en cours d'exécution (Docker Desktop sur Windows et macOS).

    node --version   # 24 or newer
    docker info      # daemon reachable
  2. 2

    Clonez et installez

    L'étape d'installation compile également le CSS du panneau. Aucun module natif à compiler.

    git clone https://github.com/anefzaoui/minecraft-server-manager.git
    cd minecraft-server-manager
    pnpm install
  3. 3

    Démarrez le panneau

    Par défaut, il écoute uniquement sur localhost. Définissez PANEL_HOST=0.0.0.0 pour y accéder depuis d'autres machines sur votre réseau.

    pnpm start
  4. Puis ouvrez le panneau

    http://localhost:25564

    La première exécution vous guide à travers une vérification du système, votre fuseau horaire et la création du compte administrateur.

  1. 1

    Démarrez depuis une installation source

    Exécutez ceci depuis le dossier cloné. PM2 lance les applications avec la version Node qui a démarré son démon, donc épinglez l'interpréteur.

    pm2 start src/server.js --name minecraft-server-manager --interpreter "$(nvm which 24)"
  2. 2

    Sauvegardez la liste des processus et activez le démarrage

    pm2 startup affiche une commande à exécuter avec sudo ; exécutez-la une fois.

    pm2 save
    pm2 startup
  3. 3

    Vous préférez systemd ?

    Une unité qui exécute node src/server.js depuis le dossier cloné avec WorkingDirectory défini fonctionne de la même manière. Le panneau n'a pas besoin de drapeaux supplémentaires.

  4. Puis ouvrez le panneau

    http://{{host}}:25564

    La première exécution vous guide à travers une vérification du système, votre fuseau horaire et la création du compte administrateur.

Option 1 : Docker

Le panneau pilote le démon Docker de l'hôte via le socket monté, ce qui équivaut à un accès root sur l'hôte. Traitez le login administrateur en conséquence et n'exposez jamais le panneau directement sur Internet.

Télécharger docker-compose.ymlLire le guide de démarrage rapide

Options d'installation

L'installeur Linux prend ses options après bash -s --, elles fonctionnent donc également via le pipe. Réexécutez-le avec les mêmes options pour mettre à jour ; votre dossier de données, .env et les modifications de compose sont conservés.

--port 8080Servir le panneau sur un autre port.
curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --port 8080
--bind 127.0.0.1Écouter uniquement sur 127.0.0.1, pour un proxy inverse avec TLS en frontal.
curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --bind 127.0.0.1
--tag v0.14.1Épingler une version au lieu de suivre la plus récente.
curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --tag v0.14.1
--dir /srv/msmInstaller ailleurs que dans /opt/msm.
curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --dir /srv/msm
--uninstall --yesSupprimer le panneau et conserver ses données. Via un pipe, il n'y a pas de clavier pour répondre à la question, ajoutez donc --yes ; ajoutez également --purge pour supprimer le dossier de données.
curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --uninstall --yes
--helpChaque option, avec sa valeur par défaut.
curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --help

Prérequis

Notes pour Windows

Venez dire bonjour

Signalez des bugs, suggérez des fonctionnalités, obtenez de l'aide de vrais humains et montrez vos serveurs.