First of all, I want to really thank you all for the amazing support that BlockGate has got in such a short period of time! In just 12 hours, our project became the #1 post of the day in r/selfhosted, and we got 50 stars in the project repository!
BlockGate is an open-source, self-hosted control panel for managing and running Minecraft servers with Docker.
It was built to provide a modern, developer-friendly, and efficient way to create, manage, and monitor Minecraft instances, all from a simple and elegant web interface.
🔒 Licensed under the GNU Affero General Public License v3.0 (AGPL-3.0) — free and open for everyone, but protected against closed-source commercial forks.
- To run BlockGate, you need Docker and Docker Compose installed.
- The
docker-compose.ymlfile has all the project core dependencies - Follow the steps to run BlockGate:
git clone https://github.com/neozmmv/BlockGate
-
Go to BetterAuth and click on "Generate Secret"
-
Copy the generated secret to the
.env.examplefile and rename it to.env -
Start BlockGate with:
sudo docker compose up -d
- In the terminal, run:
pnpm dlx prisma migrate dev
and run the web app with:
pnpm dev
If you run BlockGate on your device and create a server, it will be accessible by your machine IP and PORT inside your local network. If you want to make your server accessible outside your local network (allowing friends and others to join), you'll have to put your machine and the server / VPS in the same network. You can achieve this by using some tools like TailScale or other VPN service.
BlockGate runs on localhost:3000 (Subject to change)
BlockGate lets you easily create and manage Minecraft servers on your own infrastructure.
It aims to combine the simplicity of plug-and-play panels like Aternos with the power and flexibility of full Docker orchestration.
- Self-Hosted by Design — runs entirely on your server with Docker Compose.
- Modular Architecture — built with a clear separation between the web panel and a local agent that controls Docker.
- Open Source Core — transparent and extensible; ideal for developers, communities, and enthusiasts.
- Future-Proof Foundation — ready for scaling into a multi-node hosting environment later.
- Minecraft-Focused — built exclusively for Minecraft servers, with an emphasis on simplicity, performance, and automation.
- Docker Based — all Minecraft servers are isolated Docker containers based on the
itzg/minecraft-serverimage.