Setup-Wizard¶
Nach dem ersten Start des Stacks läuft im Browser der First-Run-Wizard. Er öffnet sich automatisch beim Aufruf der Server-URL.
(oder die IP, falls keine Domain konfiguriert ist)
Schritte¶
1 — Sprache¶
Deutsch oder Englisch. Lässt sich später pro Benutzer in den Präferenzen ändern.
2 — Admin-Benutzer¶
E-Mail und Passwort des ersten Super-Admins. Dieser Account kann später nicht gelöscht werden, ohne dass ein anderer Super-Admin existiert.
E-Mail muss zustellbar sein
Der erste Super-Admin bekommt 2FA-Codes per E-Mail. Wenn die Zieladresse nicht erreichbar ist, kommst du nicht mehr rein. Eine SMTP-Konfiguration kommt später im Wizard, aber teste die E-Mail vor dem Aktivieren von 2FA.
3 — Tenant¶
Erster Mandant. Bei MSP-Nutzung: pro Kunde ein Tenant. Bei Einzelnutzung: ein einziger Tenant „Internal" reicht.
Tenant-Wechsel später: Admin → Tenants → Neu.
4 — Größe (Sizing)¶
Seit v0.17.3
Der Wizard fragt im Schritt nach SMTP nach der erwarteten Instanz-Größe.
| Profil | Hosts | Hardware-Empfehlung |
|---|---|---|
| Klein | < 50 | 2 GB RAM, 1 Core |
| Mittel | 50–500 | 4 GB RAM, 2 Cores |
| Groß | 500–2 000 | 8 GB RAM, 4 Cores |
| XL | > 2 000 | 16 GB RAM, 8 Cores |
Die Auswahl wird in system_settings.size_profile gespeichert und dient später als Referenz für Auto-Tuning. Aktuell setzt der Wizard daraus noch keine Defaults — die Werte sind reine Empfehlung. Aktive Tuning-Anwendung folgt in einem Update.
Details zur Skalierung: Administration → Skalierung.
5 — SMTP (optional)¶
Für E-Mail-Benachrichtigungen und 2FA-Codes:
| Feld | Beispiel |
|---|---|
| Host | smtp.example.com |
| Port | 587 (STARTTLS) oder 465 (SMTPS) |
| Benutzer | noreply@example.com |
| Passwort | App-Passwort, kein Personenpasswort |
| Absender | Vesana <noreply@example.com> |
Mit „Test-E-Mail" prüfst du sofort, ob die Konfig stimmt.
Wenn SMTP übersprungen wird, sind 2FA und Alert-E-Mails deaktiviert. Push-Benachrichtigungen funktionieren weiterhin.
6 — Lizenz (optional)¶
Lizenzschlüssel im Format OVS-XXXX-XXXX-XXXX. Wenn du mit Community startest, leer lassen.
Lizenzen lassen sich später unter Admin → Lizenz nachtragen.
Details: Lizenz-Tiers.
7 — Localhost-Monitoring (optional)¶
Aktiviert ein paar Default-Checks auf den Stack selbst (CPU, Memory, Disk, Service-Status der eigenen Container). Empfehlung: aktivieren — du siehst sofort etwas im Dashboard.
8 — Zusammenfassung¶
Alle Eingaben werden zusammengefasst, dann „Setup abschließen". Du landest direkt im Login.
Setup übersprungen — nachholen¶
Wenn der Wizard versehentlich abgebrochen wurde, kannst du ihn unter https://deine-domain.tld/setup erneut aufrufen, solange noch kein Admin angelegt wurde.
Sobald ein Admin existiert, redirected /setup automatisch zum Login.
Tester-Mode¶
Tester-Mode
Bei VESANA_TESTER_MODE=true in der .env überspringt der Wizard den Lizenz-Schritt automatisch. Alle Features sind freigeschaltet, der Server registriert sich beim Lizenzportal als Tester-Instanz.
Details: Self-Hosting → Tester-Mode.