Ersteinrichtung

Nach der Installation besteht die Ersteinrichtung aus zwei Phasen:

1. Setup-Wizard — Admin-Account erstellen (unauthentifiziert, zeitbegrenzt)
2. Onboarding — Organisation, Environment und Stack Sources konfigurieren (authentifiziert, geführt)

---

Phase 1: Setup-Wizard

Der Setup-Wizard startet automatisch beim ersten Zugriff auf die Web-Oberfläche. Er besteht aus einem einzigen Schritt: der Erstellung des Admin-Accounts.

Zeitlimit

Der Setup-Wizard hat ein 5-Minuten-Timeout aus Sicherheitsgründen. Falls der Timer abläuft, starte den Container neu:

docker restart readystackgo

Admin-Account erstellen

Gib deine Administrator-Zugangsdaten ein:

Feld	Anforderung
Username	Mindestens 3 Zeichen
Password	Mindestens 8 Zeichen
Confirm Password	Muss mit dem Passwort übereinstimmen

Das Formular validiert deine Eingaben vor dem Absenden:

Was passiert nach dem Absenden?

Wenn du auf “Continue” klickst:

1. Der Admin-Account wird erstellt
2. Du wirst automatisch eingeloggt (kein separater Login-Schritt)
3. Der Wizard markiert sich als abgeschlossen
4. Du wirst automatisch zum Onboarding weitergeleitet

Wichtig

Dieser Account ist der einzige Weg, auf ReadyStackGo zuzugreifen. Bewahre die Zugangsdaten sicher auf — sie können später nicht wiederhergestellt werden!

---

Phase 2: Onboarding

Nach dem Wizard startet automatisch das geführte Onboarding. Es führt dich in drei Schritten durch die Grundkonfiguration deiner ReadyStackGo-Instanz.

Pflicht

Das Onboarding ist nicht überspringbar. Erst wenn mindestens die Organisation konfiguriert ist, wirst du zur Anwendung weitergeleitet. Bei jedem Login prüft ReadyStackGo, ob das Onboarding abgeschlossen ist.

Schritt 1: Organisation erstellen

Die Organisation ist die Top-Level-Identität deiner ReadyStackGo-Instanz. Alle Environments, Stacks und Einstellungen gehören zu ihr. Dieser Schritt ist Pflicht — es gibt keinen “Überspringen”-Button.

Feld	Anforderung
Organization Name	Mindestens 2 Zeichen

Gib einen Namen ein und klicke auf “Continue”.

Tipp

Du kannst den Organisationsnamen später jederzeit in den Einstellungen ändern.

---

Schritt 2: Docker Environment hinzufügen

In diesem Schritt verbindest du ReadyStackGo mit einem Docker-Daemon. Die Felder sind vorausgefüllt mit sinnvollen Standardwerten:

Feld	Standardwert	Beschreibung
Environment Name	Local Docker	Frei wählbarer Name für dieses Environment
Docker Socket Path	unix:///var/run/docker.sock	Pfad zum Docker-Daemon-Socket auf dem Host

Du hast zwei Möglichkeiten:

• “Continue” — Erstellt das Environment mit den angegebenen Werten
• “Skip for now” — Überspringt diesen Schritt (du kannst später Environments in den Einstellungen hinzufügen)

Docker Socket

Wenn du ReadyStackGo als Docker-Container betreibst, muss der Docker-Socket des Hosts in den Container gemountet sein (standardmäßig konfiguriert in der docker-compose.yml).

---

Schritt 3: Stack Sources auswählen

Stack Sources sind Repositories mit vorkonfigurierten Stack-Definitionen, die du direkt deployen kannst. ReadyStackGo zeigt dir eine kuratierte Liste verfügbarer Quellen an:

• Empfohlene Quellen (Featured) sind automatisch vorausgewählt
• Du kannst Quellen an- und abwählen
• Klicke auf “Add sources”, um die ausgewählten Quellen hinzuzufügen
• Oder klicke auf “Skip for now”, um diesen Schritt zu überspringen

Stack Sources

Du kannst Stack Sources jederzeit unter Settings → Stack Sources hinzufügen, entfernen oder eigene Git-Repositories als Quelle konfigurieren.

---

Schritt 4: Zusammenfassung

Nach Abschluss der Schritte zeigt dir das Onboarding eine Zusammenfassung aller konfigurierten (und übersprungenen) Punkte:

Klicke auf “Go to Dashboard”, um zum Dashboard zu gelangen.

---

Nach dem Setup

Nach Abschluss des Onboardings wirst du auf das Dashboard weitergeleitet:

Falls du im Onboarding optionale Schritte übersprungen hast (Environment oder Stack Sources), zeigt das Dashboard einen Hinweis mit Empfehlungen zur weiteren Konfiguration. Dieser Hinweis verschwindet automatisch, sobald alle Punkte konfiguriert sind.

Nächste Schritte

1. Environment hinzufügen (falls übersprungen) — Gehe zu Environments und erstelle ein neues Environment
2. Stack Sources konfigurieren (falls übersprungen) — Unter Settings → Stack Sources
3. Ersten Stack deployen — Siehe Ersten Stack deployen

---

Troubleshooting

Wizard startet nicht

Falls der Wizard nicht automatisch startet:

# Container-Logs prüfen
docker logs readystackgo

# Container neustarten
docker restart readystackgo

Wizard zurücksetzen

Falls du den Wizard erneut durchlaufen möchtest, musst du die Daten zurücksetzen:

# Container mit Volumes stoppen und löschen
docker compose down -v

# Container neu starten
docker compose up -d

Warnung

Das Löschen der Volumes entfernt alle Konfigurationen und Deployment-Informationen!