Getting Started

Introduction

Learn what MCSM is, how it works and when to use it

MCSM (Minecraft Server Manager) is a self-hostable web app for spinning up and managing Minecraft servers. You configure a server in a guided wizard — type, version, memory, world settings, MOTD, operators and whitelist — and MCSM provisions it as a Docker container running the battle-tested itzg/minecraft-server image.

What you can do

  • Create servers in minutes — a 4-step wizard covers Vanilla, Paper, Fabric, Forge, Feed The Beast and CurseForge modpacks.
  • Manage everything from the browser — start, stop, restart, edit and delete servers; stream the console; manage players, mods and config files.
  • Route by domain — each server gets its own domain (e.g. survival.mc.example.com) handled by the Infrarust proxy. No ports to juggle, no proxy config files to maintain.
  • Keep your worlds safe — one-click world backups with download, upload and restore.
  • Watch your servers — per-minute analytics for CPU, memory, network, latency and player counts.
  • Go further — BlueMap 3D world maps, Chunky world pre-generation, a Modrinth browser with one-click installs, and more.

How it works

Your browser

The MCSM dashboard

create wizard · console · backups

MCSM

Nuxt + Nitro, self-hosted

Docker Engine API — create, start, label

Game clients

survival.mc.example.com

Minecraft protocol · port 25565

Infrarust proxy

Routes each domain to its container

discovers containers by their labels
Docker daemon
S

survival

itzg/minecraft-server

C

creative

itzg/minecraft-server

M

modpack

itzg/minecraft-server

Each server is an ordinary labeled container with its world on a named volume — the full config lives in the mcsm.config label.

  1. You fill out the create wizard in the dashboard.
  2. MCSM creates a Docker container from the itzg/minecraft-server image — every setting becomes an environment variable, the world lives on a named volume, and the container gets infrarust.* routing labels.
  3. Infrarust, watching the same Docker daemon, discovers the new container from its labels and starts routing its domain to it immediately.

Docker is the source of truth for server configuration: the full config is stored on the container as a label, so there's nothing to keep in sync. Everything that must survive container recreation — analytics history, the activity feed, backups, user accounts — lives in a local SQLite database.

When to use MCSM

Use MCSM when you:

  • run Minecraft servers for friends, family or a community and want a clean web UI instead of SSH and shell scripts,
  • want every server reachable under its own domain without managing proxy configs or exposing extra ports,
  • already run Docker (or are happy to) and want servers to be ordinary, inspectable containers rather than an opaque runtime.
MCSM is an early-stage open source project under active development — APIs and structure may still change. It's licensed under the MIT License.

Next steps

Copyright © 2026