SayfeCraft Docs

01

Quickstart

1

ZIP herunterladen

Lade das passende Paket für Windows oder Linux im Dashboard herunter.

2

Entpacken & starten

Führe install.bat (Windows) oder install.sh (Linux) aus. Anschließend startet start.bat das Panel.

3

Admin-Passwort setzen

Beim ersten Öffnen von /admin erscheint der Erstinstallations-Dialog. Legen ein Passwort fest.

02

Installation

Das Panel benötigt Python 3.11+ und funktioniert unter Windows und Linux nahezu identisch.

Entpacke das ZIP in einen Ordner, z. B. C:\SayfeCraft\panel.
Führe install.bat aus – es richtet die virtuelle Umgebung ein.
Starte start.bat. Das Panel läuft dann unter http://127.0.0.1:8082.

start.bat

cd /d C:\SayfeCraft\panel
.venv\Scripts\python.exe app.py

Entpacke das ZIP, z. B. nach /opt/minecraft/panel.
Mache install.sh ausführbar und führe es aus.
Starte mit ./start.sh oder richte einen systemd-Service ein.

Terminal

tar -xzf sayfecraft-panel-linux.zip -C /opt/minecraft
chmod +x /opt/minecraft/panel/install.sh /opt/minecraft/panel/start.sh
/opt/minecraft/panel/install.sh
/opt/minecraft/panel/start.sh

03

Erstinstallation

Beim ersten Start ist kein Admin-Benutzer vorhanden. Öffne /admin, um das Panel zu initialisieren.

Hinweis: Falls du dich bereits im Panel befindest und nur die Login-Seite siehst, wurde das Setup noch nicht durchlaufen. Starte das Panel neu und rufe /admin auf.

Schritt 1: Setup-Dialog

Die Seite fragt nach einem Panel-Namen und einem Admin-Passwort. Das Passwort muss mindestens 6 Zeichen lang sein.

Schritt 2: Login

Danach meldest du dich mit dem Benutzernamen admin und deinem neuen Passwort an.

04

Dashboard

Über sayfecraft.online/dashboard verwaltest du Lizenzen, Panels und deinen Account.

Lizenz & Panels

Registriere dein Panel, ordne es deinem Account zu und verwalte Updates zentral.

SSO-Login

Mit „Anmelden“ im Dashboard loggst du dich automatisch im lokalen Panel ein – ohne separates Passwort.

05

Admin & SSO

Es gibt zwei Wege, ins Panel zu kommen: direkter Admin-Login und Single-Sign-On über das Dashboard.

Methode	Benutzername	Passwort	Verwendung
Lokaler Admin	`admin`	Beim Setup vergeben	Direkter Zugriff auf `/admin`
SSO über Dashboard	SayfeCraft-Account	SayfeCraft-Account	Button „Anmelden“ im Dashboard

Session-Cookies: Auf lokalen HTTP-Instanzen verwendet das Panel dynamische Secure-Cookies: nur bei HTTPS wird das Secure-Flag gesetzt. Bei http://127.0.0.1 funktioniert der Login dadurch trotzdem.

06

Selfhost hinter Nginx

Für den öffentlichen Zugriff empfehlen sich ein Reverse-Proxy und SSL.

Nginx: /panel

location ^~ /panel/ {
    proxy_pass http://127.0.0.1:8082/;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Forwarded-Prefix /panel;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_read_timeout 86400;
}

07

API-Übersicht

Das Panel stellt eine REST-API bereit. Alle Endpunkte liefern JSON.

POST/api/setupErstinstallation

POST/api/loginAdmin-Login

GET/api/statusServer-Status

POST/api/commandBefehl senden

POST/api/token-loginSSO-Token

Beispiel: Login

curl -X POST http://127.0.0.1:8082/api/login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"dein-passwort"}'

08

FAQ

Warum wird nach dem Setup immer wieder die Login-Seite angezeigt?

Das lag an einem zu früh gesetzten Secure-Flag für Session-Cookies. Aktualisiere app.py auf die neueste Version – dann funktioniert der Login auch über HTTP.

Was ist der Unterschied zwischen /admin und dem Dashboard?

/admin ist das lokale Panel auf deinem Server. Das Dashboard unter sayfecraft.online/dashboard verwaltet deinen Account, Lizenzen und SSO-Zugriff.

Kann ich mehrere Server verwalten?

Ja. Das Panel unterstützt Multi-Server: füge im Admin-Bereich weitere Server-Instanzen hinzu.

09

Support

Hilfe bekommst du am schnellsten direkt im SayfeSpace-Discord oder über das Dashboard.

SayfeSpace besuchen Dashboard

Alles, was du für SayfeCraft brauchst