• Server Lifecycle — Start, stop, restart, and delete servers with a single click
• Web Terminal — Pterodactyl-style live console: read-only xterm.js display, dedicated command input bar with > prompt, real-time WebSocket + polling fallback, connection status dot
• File Manager — Browse, edit, upload, and delete server files
• Backup System — Create, restore, and delete .tar.gz backups
• Auto Backup — Scheduled backups with customizable interval and retention
• Plugin Manager — Search and install plugins from Modrinth and Hangar
• Server Downloader — Download Paper, Folia, Purpur, Vanilla, Fabric, Quilt, Forge, and NeoForge
• Auto-Upgrade — Upgrade server JARs to the latest version with automatic backup
• ZIP Import — Import existing server directories via drag-and-drop ZIP upload
• Server Properties Editor — Edit server.properties directly from the UI
• Authentication — Login/register system with session-based auth
• Dark/Light Theme — Toggle between dark and light mode; terminal 16-color ANSI palette adapts per theme
• Docker Support — Run servers in isolated Docker containers
• EULA Auto-Create — eula=true written automatically on server creation
• Launch Arguments — Customize JVM arguments per server

The script installs Python and Java if missing, creates a virtual environment, installs dependencies, optionally sets up autostart, and launches the panel. If node is available, static assets are built automatically.

💡 For the fastest possible experience, ensure Node.js 18+ is installed (tested on 26.1) — JS files are bundled and minified via esbuild, CSS via csso, and all text responses are gzip-compressed.

# Clone the repository
git clone https://github.com/enis1enis2/GreatPanel.git
cd GreatPanel

# (Optional) Build optimized static assets
# Requires Node.js 18+ — JS is bundled via esbuild, CSS via csso
npm install && npm run build

# Create and activate a virtual environment
python3 -m venv .venv
source .venv/bin/activate      # Linux/macOS
# .venv\Scripts\activate        # Windows

# Install dependencies
pip install -r requirements.txt

# Launch
python app.py

Open http://localhost:8080 in your browser and log in with:

Username: admin · Password: admin

⚠️ Change the default password after first login!

💡 The app works without the build step using the original JS/CSS files. npm run build bundles 7 JS files into 1 via esbuild, minifies CSS via csso. All text responses are gzip-compressed automatically. The terminal layout is Pterodactyl-inspired: read-only xterm display with a dedicated command input bar.

Windfall ECU is configured via environment variables:

docker compose up -d

The Dockerfile uses python:3.12-slim with OpenJDK 21 JRE. Server data and backups are stored in mounted volumes.

All endpoints except auth require authentication via session cookie.

• Backend: Flask, Flask-SocketIO, SQLite, Eventlet
• Frontend: Vanilla JavaScript (bundled via esbuild), xterm.js (read-only terminal + command input bar), Socket.IO client
• Build: esbuild (JS bundling + minify), csso (CSS minify)
• Compression: Automatic gzip for HTML/CSS/JS/JSON responses
• Container: Docker / Docker Compose