Schnellstart

So richtest du das Panel, seine Datenbank und einen Node auf derselben Maschine ein, mit Docker Compose. Für eine Installation, die aus dem Internet erreichbar ist, geht es weiter unter Panel installieren.

Du brauchst Docker mit dem Compose-Plugin sowie compose.yml und .env.example aus dem Ordner deploy/ im Repository des Panels, in einem leeren Ordner.

1. Panel starten

cp .env.example .env          # POSTGRES_PASSWORD setzen, und PANEL_PUBLIC_URL=http://127.0.0.1:8080
docker compose up -d

Öffne den Link mit dem Setup-Token, den das Panel in sein Log schreibt (docker compose logs panel | grep setup). Der Setup-Assistent fragt, wie du das Panel nutzt (Homelab oder Hosting), und legt dein Operator-Konto und den ersten Tenant an.

Master-Key aufbewahren

Der erste Start legt keys/master.key an. Er verschlüsselt die Secrets in der Datenbank (Steam-Passwörter, geheime Variablen). Sichere ihn zusammen mit der Datenbank; ohne ihn lassen sich gespeicherte Secrets nicht mehr entschlüsseln.

2. Die Maschine als Node hinzufügen

1. Gehe im Panel zu Nodes → Add node. Trage einen Namen ein, die Adresse, die Spieler verwenden (für einen Test: 127.0.0.1), und einen Portbereich, z. B. 30000-30019.
2. Das Panel zeigt einen Befehl mit einem einmaligen Token. Auf dieser Maschine nimmst du stattdessen den Agent der Compose-Datei: Trag das Token in .env als AGENT_ENROLLMENT_TOKEN=… ein und führe docker compose --profile agent up -d aus.
3. Nach wenigen Sekunden ist der Node online.

3. Einen Server anlegen

1. Games → Catalogue: ein Spiel hinzufügen, z. B. Minecraft (Paper).
2. Servers → New server: Spiel und Node wählen, die vorgeschlagenen Werte übernehmen.
3. Die Installation läuft und zeigt ihre Ausgabe in der Konsole. Minecraft verlangt, dass du die EULA akzeptierst: Die Serverseite zeigt dafür einen Button.
4. Start. Die Serverseite zeigt die Adresse, mit der sich Spieler verbinden.

Weiter

• Begriffe
• Nodes: Ports, SFTP und die Einstellungen des Agents
• Server