Dokumentation
Fehlerbehebung beim Self-Hosting
Was jede Meldung bedeutet und was zu tun ist, aus den Problemen einer echten Installation.
Web
Während der Installation
- „Dieser Installationsbefehl ist abgelaufen, wurde benutzt oder ersetzt“: Erstellen Sie unter Einstellungen → Self-Hosting einen neuen und führen Sie diesen aus.
- „Kein Terminal für die drei Fragen“: Aus einer SSH-Sitzung ausführen oder --host, --tls und --storage übergeben.
- Stopp bei der Namensprüfung: Der DNS-Eintrag muss auf die Adresse dieses Servers zeigen. Änderungen können bis zu einer Stunde dauern.
- Ports 80 oder 443 belegt: Ein anderer Webserver läuft. Stoppen Sie ihn oder nutzen Sie einen sauberen Server.
- Das Laden der Images schlug dreimal fehl: Prüfen Sie ausgehendes HTTPS des Servers und führen Sie denselben Befehl erneut aus.
- Das Zertifikat schlägt fehl: Ports 80 und 443 müssen aus dem Internet erreichbar sein, oder wählen Sie ein eigenes Zertifikat oder die Option für interne Netzwerke.
Anmeldung
- „Anmeldung konnte nicht abgeschlossen werden“: Der Server erreichte FlowX nicht. Prüfen Sie ausgehendes HTTPS zu license.flowx.ninja und ob die Zeitsynchronisierung (NTP) aktiv ist, dann erneut versuchen.
- „Dieser Arbeitsbereich existiert nicht“ auf der eigenen Adresse Ihres Servers oder ein Sprung zu einer Adresse wie ihr-bereich.yourcompany.com nach der Anmeldung: Der Server läuft mit einer Version vor 0.1.22. Führen Sie sudo flowx upgrade aus.
- Jemand kann sich gar nicht anmelden: Prüfen Sie, ob die Person noch Mitglied des Arbeitsbereichs in Ihrem FlowX-Konto ist und ihr Konto aktiv ist.
Betrieb und Updates
- Die Self-Hosting-Seite meldet, dass der Server sich zuletzt nicht gemeldet hat: Prüfen Sie, ob er läuft und license.flowx.ninja erreicht, dann sudo flowx doctor ausführen.
- Ein Upgrade schlug fehl: Es ist bereits auf die vorherige Version zurückgerollt. Lesen Sie sudo flowx logs api --tail 200, beheben Sie die Ursache und starten Sie das Upgrade erneut.
- Signatur- oder Zeitfehler: Schalten Sie die Zeitsynchronisierung (NTP) auf dem Server ein.
- E-Mails kommen nicht an: Richten Sie unter Einstellungen → Server den E-Mail-Versand (SMTP) ein und nutzen Sie die Testen-Schaltfläche.
Hilfe erhalten
Öffnen Sie über die Support-Schaltfläche in FlowX ein Ticket. Führen Sie sudo flowx support-bundle auf dem Server aus und hängen Sie die Datei an: Sie enthält bereinigte Logs und Prüfungen, nie Inhalte Ihres Arbeitsbereichs, und zeigt Ihnen vor dem Schreiben, was gesammelt wurde.
Verwandt