Install
Pick the option that matches your host. Every path gives you the same panel.
Up and running in minutes
Pick your machine and paste the commands. Advanced has every other way to run the panel, with the commands rewritten for your own folder and address.
- 1
Run the installer
Works on any Linux machine with a 64-bit OS, from a VPS to a Raspberry Pi 4 or 5. It installs Docker if it is missing, sets the panel up in /opt/msm, and starts it. Run it again later to upgrade.
curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash - 2
Open the panel
The installer prints the address and a one-time setup PIN. Open the address in a browser, enter the PIN, and create your admin account.
http://your-server-ip:25564
- 1
Install Docker Desktop, Node.js, Git and pnpm
One line each in PowerShell. Start Docker Desktop once it is installed and leave it running.
winget install Docker.DockerDesktop winget install OpenJS.NodeJS.LTS winget install Git.Git winget install pnpm.pnpm - 2
Get the panel and start it
Open a new terminal so it finds the tools you just installed.
git clone https://github.com/anefzaoui/minecraft-server-manager.git cd minecraft-server-manager pnpm install pnpm start - 3
Open the panel
The first run walks you through a system check, your time zone, and creating the admin account.
http://localhost:25564
- 1
Install Docker Desktop, Node.js, Git and pnpm
With Homebrew. Start Docker Desktop once it is installed and leave it running.
brew install --cask docker-desktop brew install node git pnpm - 2
Get the panel and start it
The install step also builds the panel. There is nothing to compile.
git clone https://github.com/anefzaoui/minecraft-server-manager.git cd minecraft-server-manager pnpm install pnpm start - 3
Open the panel
The first run walks you through a system check, your time zone, and creating the admin account.
http://localhost:25564
Fill in the two fields and every command below rewrites itself for your machine.
- 1
Create the data folder
One folder holds everything the panel owns.
mkdir -p {{dataDir}} - 2
Download the compose file and point it at that folder
DATA_DIR_HOST must be the absolute path on the host, because Docker mounts it from the host's point of view.
curl -fsSLO https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/docker-compose.yml echo "DATA_DIR_HOST={{dataDir}}" > .env - 3
Start the panel
The image is multi-arch (amd64 and arm64) and updates on every release.
docker compose up -d Then open the panel
http://{{host}}:25564The first run walks you through a system check, your time zone, and creating the admin account.
- 1
Create the data folder on the host
Same folder rule: absolute path, on the machine that runs Docker.
mkdir -p {{dataDir}} - 2
Add a stack from the compose file
Paste the contents of the compose file into a new stack. The raw file is here:
https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/docker-compose.yml - 3
Set the environment variable and deploy
Add it in the stack's environment section, then deploy.
DATA_DIR_HOST={{dataDir}} Then open the panel
http://{{host}}:25564The first run walks you through a system check, your time zone, and creating the admin account.
- 1
Check the requirements
Node.js 24 or newer, pnpm, and Docker running (Docker Desktop on Windows and macOS).
node --version # 24 or newer docker info # daemon reachable - 2
Clone and install
The install step also builds the panel's CSS. No native modules to compile.
git clone https://github.com/anefzaoui/minecraft-server-manager.git cd minecraft-server-manager pnpm install - 3
Start the panel
By default it listens on localhost only. Set PANEL_HOST=0.0.0.0 to reach it from other machines on your network.
pnpm start Then open the panel
http://localhost:25564The first run walks you through a system check, your time zone, and creating the admin account.
- 1
Start from a source install
Run this from the cloned folder. PM2 launches apps with the Node version that started its daemon, so pin the interpreter.
pm2 start src/server.js --name minecraft-server-manager --interpreter "$(nvm which 24)" - 2
Save the process list and enable startup
pm2 startup prints one command to run with sudo; run it once.
pm2 save pm2 startup - 3
Prefer systemd?
A unit that runs node src/server.js from the cloned folder with WorkingDirectory set works the same way. The panel needs no extra flags.
Then open the panel
http://{{host}}:25564The first run walks you through a system check, your time zone, and creating the admin account.
Option 1: Docker
Installer Options
The Linux installer takes its options after bash -s --, so they work through the pipe as well. Run it again with the same options to upgrade; your data folder, .env and compose edits are kept.
--port 8080Serve the panel on another port.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --port 8080--bind 127.0.0.1Listen on 127.0.0.1 only, for a reverse proxy with TLS in front.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.1Pin a release instead of following the newest one.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --tag v0.14.1--dir /srv/msmInstall somewhere other than /opt/msm.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --dir /srv/msm--uninstall --yesRemove the panel and keep its data. Through a pipe there is no keyboard to answer the question, so add --yes; add --purge as well to delete the data folder.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --uninstall --yes--helpEvery option, with its default.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --help
Requirements
- Docker Engine (Linux) or Docker Desktop (Windows, macOS).
- Docker
- Linux
Windows- macOS
- Node.js 24 or newer for the from-source install. The Docker image bundles its own.
- Node.js 24+
- A few gigabytes of disk for server images and worlds.
Windows notes
- Docker Desktop must be running before you start or create servers.
- Share your project drive with Docker Desktop (Settings, Resources, File sharing) so bind mounts work.
- The Docker image targets Linux hosts; on Windows and macOS run the panel from source.

Come say hi
Report bugs, suggest features, get help from real humans, and show off your servers.
