Cubeherd

Open source · MIT · self-hosted

A lean dashboard for your Minecraft servers on Docker

Create, start, update, back up and uninstall servers built on itzg/docker-minecraft-server, including Modrinth and CurseForge modpacks. One Go binary, around 10 MB of RAM, no database.

Cubeherd overview with two running Minecraft servers
~10 MBRAM
0 %CPU when idle
1Go binary, no database
MITLicense

Everything you need to run a Minecraft server at home

Cubeherd runs next to your servers and takes next to nothing from them.

Create in minutes

Vanilla, Paper, Purpur, Folia, Fabric, Quilt, Forge, NeoForge or a modpack from Modrinth or CurseForge. The right Java image is picked for you.

Live console

Run commands over RCON, watch logs stream in, and see CPU, RAM and online players while a page is open.

Backups that restore

Manual, scheduled and automatic before every update. Restore or download them, or ship them to S3-compatible storage.

Mods and plugins

Search Modrinth, CurseForge and Spigot, add and remove entries, or upload your own JARs. Works on top of modpacks too.

Files and worlds

Browse, edit, upload and download server files. Export a world as a ZIP or import one.

Updates

Move to a new Minecraft version, modpack version or itzg image without touching a terminal.

Idle and limits

Pause or fully stop servers when nobody is playing, and cap CPU per server.

Players

Manage the whitelist, operators and bans from the browser.

No lock-in

Each server is a plain compose.yml in its own folder. Uninstall Cubeherd and your servers keep running.

See it in action

Live console with RCON, CPU, RAM and online players
Live console with RCON, CPU, RAM and online players
Search Modrinth, CurseForge and Spigot for mods and plugins
Search Modrinth, CurseForge and Spigot for mods and plugins
Scheduled and manual backups with restore
Scheduled and manual backups with restore
File browser, editor and world import and export
File browser, editor and world import and export

Up and running in one command

Requires Docker with the Compose plugin on the host.

docker run -d --name cubeherd --restart unless-stopped \
  -p 8420:8420 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /srv/cubeherd:/srv/cubeherd \
  -e CUBEHERD_DATA=/srv/cubeherd \
  ghcr.io/matserix/cubeherd:latest

Open http://<host>:8420 and set the admin password on first visit. See the full installation guide for Compose and binary installs.

Only expose Cubeherd on your LAN or via VPN. Whoever can operate it controls Docker, and in practice the whole host.

Frequently asked questions

What is Cubeherd?

Cubeherd is a self-hosted web dashboard for itzg/docker-minecraft-server. It creates, starts, updates, backs up and uninstalls Minecraft servers, including modpacks from Modrinth and CurseForge, from one browser tab.

How much memory and CPU does Cubeherd use?

Cubeherd is a single Go binary that needs around 10 MB of RAM and 0 % CPU when idle. It has no database and does no background polling: live data such as the console, CPU and RAM only flows while a page is open.

Which server types and modpacks are supported?

Vanilla, Paper, Purpur, Folia, Fabric, Quilt, Forge and NeoForge, plus modpacks from Modrinth and CurseForge. The matching Java image is derived from Mojang's version data.

Can I use my existing itzg containers?

Yes. Cubeherd can adopt existing itzg/docker-minecraft-server containers. Every server it manages lives in its own folder as a plain compose.yml, so it keeps working with docker compose even without Cubeherd.

Does Cubeherd back up my worlds?

Yes. Backups can be manual or scheduled, run automatically before updates, and can be restored or downloaded. They can optionally be uploaded to S3-compatible storage such as AWS S3, Backblaze B2, Hetzner, Wasabi, Cloudflare R2 or MinIO.

Is it safe to expose Cubeherd to the internet?

No. Anyone who can operate Cubeherd controls Docker and therefore, in practice, the whole host. Keep it on your LAN or behind a VPN. It has a single bcrypt-protected admin account, signed session cookies, login throttling and CSRF protection.

Is Cubeherd free?

Yes. Cubeherd is open source under the MIT license. It is not an official Minecraft product and is not affiliated with Mojang Studios or Microsoft.

Herd your cubes

Free, open source, and ready for your next world.