Dokumentation
FlowX auf dem eigenen Server installieren
Betreiben Sie den Arbeitsbereich auf einem Linux-Server, den Sie kontrollieren: vorbereiten, Installationsbefehl erstellen, ausführen und gesund halten.
Bevor Sie beginnen
Self-Hosting ist ein Add-on der Tarife Business, Professional und Enterprise. Fügen Sie es in Ihrem Cloud-Arbeitsbereich unter Einstellungen → Self-Hosting hinzu. Sobald es bezahlt ist, kann ein Inhaber oder Admin den Installationsbefehl erstellen. Bereiten Sie einen Server vor:
- Linux: Ubuntu 22.04 oder 24.04, Debian 12 oder die RHEL-9-Familie.
- Empfohlen: 4 CPUs, 8 GB RAM und 50 GB SSD. Es läuft mit 2 CPUs, 4 GB und 20 GB, aber unter Last langsam.
- Ein Name wie flowx.yourcompany.com mit einem DNS-Eintrag, der auf den Server zeigt.
- Ports 80 und 443 offen für alle, die FlowX nutzen.
- Ausgehendes HTTPS zu license.flowx.ninja und get.flowx.ninja. FlowX verbindet sich nie nach innen.
- Zeitsynchronisierung (NTP) eingeschaltet. Docker ist optional: Das Installationsprogramm bietet an, es zu installieren.
Ein Server, der nur im Firmennetz erreichbar ist, funktioniert auch: Wählen Sie bei der Installation Ihr eigenes Zertifikat oder die Option für interne Netzwerke.
In vier Schritten installieren
- 1. Öffnen Sie im Cloud-Arbeitsbereich Einstellungen → Self-Hosting und wählen Sie Installationsbefehl erstellen. Er funktioniert einmal, 24 Stunden lang, und wird nur einmal angezeigt. Ein neuer Befehl hebt den vorherigen auf.
- 2. Melden Sie sich mit einem Benutzer mit sudo-Rechten am Server an, fügen Sie den Befehl ein und drücken Sie Enter. Das Installationsprogramm prüft zuerst den Server und sagt, was zu beheben ist.
- 3. Beantworten Sie drei Fragen: die Adresse, die Ihre Nutzer öffnen; das Zertifikat (automatisch und kostenlos, dafür müssen Ports 80 und 443 aus dem Internet erreichbar sein; Ihr eigenes; oder internes Netzwerk, bei dem Browser warnen); und wo Dateien liegen (Festplatte dieses Servers oder ein vorhandener S3-kompatibler Bucket).
- 4. Lassen Sie Einstellungen → Self-Hosting geöffnet: Die Seite zeigt Verbindung, regelmäßige Meldungen und die erste Anmeldung, sobald sie passieren. Öffnen Sie dann Ihre Adresse und melden Sie sich mit Ihrem gewohnten FlowX-Konto an.
Der neue Server startet leer. Aufgaben, Anfragen und Dateien des Cloud-Arbeitsbereichs wandern nicht von selbst dorthin; wenden Sie sich vor dem Wechsel an den Support, wenn Sie sie dort brauchen.
Direkt nach der Installation
- Bewahren Sie das Wiederherstellungsblatt, das das Installationsprogramm nach /opt/flowx/RECOVERY.txt schreibt, in einem Passwortmanager auf oder drucken Sie es aus, und löschen Sie dann die Datei. Es enthält den einzigen Schlüssel, der Ihre Backups entschlüsseln kann; FlowX hat keine Kopie.
- Öffnen Sie im FlowX des Servers Einstellungen → Server und arbeiten Sie die Checkliste ab: E-Mail-Versand (SMTP), optionaler E-Mail-Eingang (IMAP), Dateien, Backups, Update-Fenster und Sicherheit. Jeder Schritt hat eine Testen-Schaltfläche.
Befehle für den Alltag
Führen Sie diese auf dem Server mit sudo aus:
- flowx status — was läuft, welche Version und das letzte Backup.
- flowx doctor — eine vollständige Prüfung mit einer Lösung für jedes gefundene Problem.
- flowx logs api --tail 200 — die letzten Logzeilen eines Dienstes.
- flowx backup now — sofort ein geprüftes, verschlüsseltes Backup.
- flowx upgrade — erstellt zuerst ein geprüftes Backup und rollt von selbst zurück, wenn die neue Version nicht startet. flowx rollback kehrt von Hand zur vorherigen Version zurück.
- flowx export — alles in Standardformaten, wenn Sie wechseln oder eine Kopie brauchen.
Wenn etwas schiefgeht
- Das Installationsprogramm stoppt bei der Namensprüfung: Der DNS-Eintrag muss auf die Adresse dieses Servers zeigen. Änderungen können bis zu einer Stunde dauern.
- Das Zertifikat schlägt fehl: Ports 80 und 443 müssen aus dem Internet erreichbar sein, oder wählen Sie Ihr eigenes Zertifikat.
- „Token abgelaufen oder benutzt“: Erstellen Sie unter Einstellungen → Self-Hosting einen neuen Installationsbefehl.
- Signatur- oder Zeitfehler: Schalten Sie die Zeitsynchronisierung (NTP) auf dem Server ein.
- Die FlowX-Anmeldung ist nicht erreichbar: Bereits offene Sitzungen funktionieren weiter. Der optionale schreibgeschützte Notfall-Admin (flowx break-glass) erlaubt in der Zwischenzeit Lesen und Exportieren.
Hilfe erhalten
Öffnen Sie über die Support-Schaltfläche in FlowX ein Ticket. Führen Sie auf dem Server sudo flowx support-bundle aus und hängen Sie die Datei an: Sie enthält bereinigte Logs und Statusprüfungen, nie Inhalte Ihres Arbeitsbereichs, und Sie sehen den Inhalt, bevor sie geschrieben wird.
Verwandt