Minecraft Server Management Dashboard

Simple Flask web dashboard to start/stop/restart a Minecraft Java server and watch logs.

Features

• Web UI on port 6767
• Start / Stop / Restart controls
• Running status and PID display
• Recent log viewer

Setup

cd /home/sc/minecraft-dashboard
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Run

cd /home/sc/minecraft-dashboard
source .venv/bin/activate
python app.py

Open: http://localhost:6767

Configuration

Optional environment variables:

• MC_SERVER_DIR (default: /home/sc/minecraft-server)
• MC_START_COMMAND (default: java -Xms1G -Xmx2G -jar server.jar nogui)
• MC_PID_FILE (default: ~/.mc-dashboard/server.pid)
• MC_LOG_FILE (default: ~/.mc-dashboard/server.log)

Example:

MC_SERVER_DIR="/home/sc/my-mc-server" \
MC_START_COMMAND="java -Xms2G -Xmx4G -jar paper.jar nogui" \
python app.py

Notes

• This dashboard manages the Minecraft process directly by PID.
• Stop uses SIGTERM then SIGKILL if needed.
• Ensure Java is installed and the start command is valid for your server files.