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
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
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
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
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
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
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
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
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
Créez le dossier de données
Un seul dossier contient tout ce qui appartient au panneau.
mkdir -p {{dataDir}} - 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
Démarrez le panneau
L'image est multi-architecture (amd64 et arm64) et se met à jour à chaque version.
docker compose up -d Puis ouvrez le panneau
http://{{host}}:25564La première exécution vous guide à travers une vérification du système, votre fuseau horaire et la création du compte administrateur.
- 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
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
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}} Puis ouvrez le panneau
http://{{host}}:25564La première exécution vous guide à travers une vérification du système, votre fuseau horaire et la création du compte administrateur.
- 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
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
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 Puis ouvrez le panneau
http://localhost:25564La première exécution vous guide à travers une vérification du système, votre fuseau horaire et la création du compte administrateur.
- 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
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
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.
Puis ouvrez le panneau
http://{{host}}:25564La 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
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
- Docker Engine (Linux) ou Docker Desktop (Windows, macOS).
- Docker
- Linux
Windows- macOS
- Node.js 24 ou plus récent pour l'installation depuis les sources. L'image Docker inclut sa propre version.
- Node.js 24+
- Quelques gigaoctets d'espace disque pour les images de serveur et les mondes.
Notes pour Windows
- Docker Desktop doit être en cours d'exécution avant de démarrer ou de créer des serveurs.
- Partagez votre lecteur de projet avec Docker Desktop (Paramètres, Ressources, Partage de fichiers) pour que les montages de liaison fonctionnent.
- L'image Docker cible les hôtes Linux ; sous Windows et macOS, exécutez le panneau depuis les sources.

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