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