Skip to content

milesmuehlbach/mcpanel

Folders and files

NameName
Last commit message
Last commit date

Latest commit

9f2aa01 · · Apr 29, 2026

History

134 Commits
Apr 17, 2026
Mar 14, 2026
Apr 26, 2026
Apr 26, 2026
Mar 20, 2026
Apr 23, 2026
Mar 22, 2026
Mar 14, 2026
Mar 14, 2026
Mar 14, 2026
Mar 14, 2026
Mar 14, 2026
Apr 26, 2026
Mar 14, 2026
Apr 23, 2026
Apr 29, 2026
Apr 18, 2026
Mar 21, 2026
Apr 29, 2026
Mar 14, 2026
Apr 26, 2026
Apr 23, 2026
Apr 18, 2026
Apr 12, 2026
Apr 16, 2026
Mar 14, 2026
Apr 12, 2026
Mar 14, 2026

Repository files navigation

mcpanel

mcpanel is a comprehensive Minecraft server hosting platform.
spanning all server softwares and game versions (editor note: rn its just paper and vanilla but we're working on support for more), we are a open-source self-hostable alternative to comprehensive hosting platforms like Aternos. We liked the functionality of such panels but were dissapointed to see that there's not a foss version with the same amount of comprehensiveness..
We mainly focus on ease of use; for example we automatically configure RAM sizes based on your computer's ram unless manually configured..
As of now, functionality is limited; currently you can create servers, manage multiple, start them, stop them, restart them, and access a full console. The majority of the work was in managing versions and downloads..

you can access a demo at mcpanel.milesmuehlbach.com

  • username: demo
  • password: password
  • the main server will be accessible from those-adding.gl.joinmc.link if/when started.

features

  • interactive server switching
  • full level of customization and ease-of-use as Aternos/Exaroton
  • open-source
  • self-hostable
  • we (@TechDudie) personally uses it in his friend group
  • free

technical details for the hc reviewers

this was a collaborative project in between @milesmuehlbach and @TechDudie.

  • svelte frontend w/ adapter-static in SSG, utilizes tailwind v4 & shadcn-svelte for HOLY PEAK ui, handled by @milesmuehlbachbach
  • async fastapi backend and stateful task management, utilizes LOTS of 3p apis/cdns for very peak reasons, handled by @TechDudie

hosting

This is a beta release, and for hosting right now we mainly have docker support. Windows/standalone binary support is in the roadmap. Copy this docker-compose.yml into a new file.

services:
   mcpanel:
     image: milesmuehlbach/mcpanel:latest
     container_name: mcpanel
     restart: unless-stopped
     ports:
      -  "8080:8080"
     environment:
       PYTHONUNBUFFERED: "1"
     volumes:
      -  ./minecraft:/app/minecraft

run docker compose up and wait for the server to run! It'll be running on port 8080. The default server port is 25565.

roadmap

This project is still in its infancy. With that said, there's lots on the roadmap.

  • automatic component updates
  • properties management
  • file browsing
  • logs within file browsing
  • port management (eg allowing for multiple ports and the like for geyser/vc etc)
  • admin/user/permissions management
  • server management (ports, networking stuff, component/software management, etc)
  • user side settings (?) reset password etc
  • potential playit.gg support
  • standalone binary support (not just running on docker)