# MCSM

MCSM is a self-hostable web dashboard that gives homelab admins one panel to provision and manage Minecraft servers—Vanilla, Paper, Fabric, Forge, or FTB/CurseForge modpacks—as Docker. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/6795/mcsm

## Description

MCSM (Minecraft Server Manager) is a self-hostable web dashboard that gives homelab admins one panel to provision and manage Minecraft servers—Vanilla, Paper, Fabric, Forge, or FTB/CurseForge modpacks—as Docker containers on Unraid, with a guided setup wizard, live console, player management, a Modrinth-powered mod browser, backups, world pre-generation, BlueMap 3D mapping, and per-server analytics.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

66/100 (Good), based on 4 of 5 factors.
- Maintained: 93 (last commit 12 days ago)
- Popular: 20 (9 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 100 (no serious findings, CI, tests)

## Links

- Official website: https://docs.mcsm.niki2k1.dev/
- Unraid: https://ca.unraid.net/apps/mcsm-18a20ap0mt9m4t?q=mcsm
- GitHub: https://github.com/Niki2k1/mcsm

## Common questions

### What do I need to configure in Unraid before the first MCSM launch?

Create the shared Docker network named infrarust and enable Preserve user defined networks under Unraid Docker settings. Set NUXT_SESSION_PASSWORD to a string of at least 32 characters and point the server data root at a real folder. Then open the WebUI and run the first-run wizard.

### Do I need a reverse proxy or a separate port for each Minecraft server?

No. Every server domain is routed through one shared port, 25565, by Infrarust using Docker labels. There are no per-server proxy config files or extra player-facing ports to manage.

### How does dashboard authentication work?

The dashboard and API require login and support password, WebAuthn passkeys, and Sign in with Microsoft. A first-run wizard creates the admin account, and published BlueMaps stay reachable without a login.

### Where are world backups stored and can I restore them?

Backups snapshot the whole world volume and are stored on the mcsm-backups volume. You can download, upload, and restore them from the dashboard.

### How do I install and update mods or plugins?

Use the built-in Modrinth browser to find builds compatible with the server loader and Minecraft version, then install them with required dependencies in one click. Installed jars are identified by SHA-1 hash, so eligible updates show a badge and can be applied in one click.

---
Source: Our Local Host (https://ourlocalhost.com/app/6795/mcsm), the self-hosted and open-source app directory.
