05 – Einrichtung über die Webseite

Datum: 08.10.2026 · Version: 0.5.0 · Status: gebaut und Ende-zu-Ende getestet

Warum

Wunsch von Philip: Der Quickstart soll nur noch den Container bzw. die VM installieren. Discord-Token, Client-ID, Secret und alle API-Schlüssel werden danach bequem im Browser eingetragen – statt in Whiptail-Fenstern in der Proxmox-Shell.

Was gebaut wurde

Installer

• fragt keine Tokens mehr, nur noch LXC/VM, Ressourcen und Netzwerk
• erzeugt zufällig: Datenbank-Passwort, Verschlüsselungs-Schlüssel (SECRETS_KEY) und Einrichtungs-Code (SETUP_CODE, z. B. MOIN-7K4P-2QXB)
• zeigt am Ende URL + Einrichtungs-Code
• moin-julia setup-code zeigt den Code jederzeit wieder; update ergänzt Code und Schlüssel bei älteren Installationen automatisch

Einrichtungs-Assistent (/setup)

Sicherheit

• Tokens und Schlüssel liegen verschlüsselt (AES-256-GCM) in der Datenbank, angezeigt werden sie nur maskiert (••••••abcd)
• der Einrichtungs-Code wird zeitkonstant verglichen; nach Eingabe gilt ein signiertes 2-Stunden-Ticket im Browser
• Instanz-Admin wird nur, wer die Einrichtung mit Code abgeschlossen hat; nach Abschluss ist /setup gesperrt
• Werte aus der .env gelten weiter als Rückfall – bestehende Installationen funktionieren ohne Änderung

System-Seite (/system)

Nur für den Instanz-Admin (Link oben rechts): Discord-Zugang, Adresse und API-Schlüssel ändern. Discord-Änderungen werden vor dem Speichern live geprüft; danach startet der Bot neu.

Bot

• Einrichtungsmodus: ohne Zugangsdaten wartet der Bot (gilt als gesund, damit Installation und Updates nicht scheitern) und startet von selbst neu, sobald der Assistent speichert
• ungültiger Token oder fehlende Intents → kein Absturz-Kreislauf mehr; das Dashboard zeigt „Bot-Token ungültig – unter System ändern“ bzw. „Intents fehlen“
• Bot-Status oben im Dashboard: online / wartet auf Einrichtung / Token ungültig / Intents fehlen

Wie getestet

Für bestehende Installationen (ab v0.7.1)

Installationen mit Tokens in der .env funktionieren weiter. Um Instanz-Admin zu werden, braucht es keinen zweiten Login mehr:

1. Im Container: update, danach moin-julia setup-code (zeigt den Code bzw. legt ihn an)
2. Im Dashboard oben rechts System → Code eingeben → Admin werden
3. Direkt danach Bot-Token, Adresse und Schlüssel ändern

Getestet Ende zu Ende (scripts/tests/claim-e2e.mjs, 7/7): Hinweis auf der Server-Seite, falscher Code abgelehnt, richtiger Code → Admin, ungültiger Token vor dem Speichern abgelehnt, gültiger gespeichert und maskiert angezeigt.

Bekannte Grenzen

• Der Einrichtungs-Code steht im Klartext in der .env (nur root lesbar) – er ist nach Abschluss der Einrichtung ohne Wirkung.
• SECRETS_KEY darf nie geändert werden, sonst sind gespeicherte Tokens unlesbar (der Assistent kann sie dann einfach neu speichern).

Nachtrag v0.8.1 – Bot-Erkennung und Einladen (Rückmeldung von Philip)

Problem: Nach dem Token-Wechsel stand im Dashboard „Bot offline“, und eingeladene Server tauchten nicht auf. Grund: Bisher hat nur der laufende Bot gemeldet, auf welchen Servern er ist. Hing er beim Verbinden oder startete er immer wieder neu, sah das Dashboard nichts und konnte auch nicht sagen, warum.

Lösung:

• Erkennung direkt über Discord: Die Server-Auswahl fragt mit dem Bot-Token selbst bei Discord nach, auf welchen Servern der Bot ist. Das klappt auch, wenn der Bot-Prozess gerade nicht läuft.
• Zurück ins Dashboard nach dem Einladen: Der Einladungs-Link nutzt dieselbe Weiterleitungs-URL wie der Login, also muss im Developer Portal nichts zusätzlich eingetragen werden. Nach „Autorisieren“ landet man direkt im Dashboard des Servers.
• Der Bot meldet immer seinen Zustand:
  • „verbindet sich“, „online“, „Token ungültig“, „Intents fehlen“ oder „Fehler“ mit Fehlertext
  • Hängt die Verbindung länger als 3 Minuten (Netzwerk, DNS), meldet er das und versucht es neu. Andere Startfehler versucht er nach 60 Sekunden erneut, statt unsichtbar neu zu starten.
• Hinweis-Karte auf der Server-Seite: Sie sagt, was zu tun ist. Meldet sich der Bot gar nicht, zeigt sie moin-julia logs bot bzw. moin-julia restart.