flowplanDokumentation
/
Zur Startseite

Selbst hosten

Speicher, S3 und Sicherung

Alle Daten liegen in einem Verzeichnis. Mit einem S3-Speicher werden Dateien gespiegelt und die Datenbank laufend gesichert – der Container hält dann nichts Unersetzliches mehr.

Was wo liegt

Pfad in /app/dataInhalt
flowplan.sqlite (+ -wal, -shm)Alle Inhalte, Konten, Sitzungen, Einstellungen
uploads/Hochgeladene Dateien
web-push-keys.jsonPush-Schlüssel, falls nicht per Umgebung gesetzt
ocr/Sprachdaten der Texterkennung, werden bei Bedarf neu angelegt

S3-Speicher einschalten

Mit S3_BUCKET und Zugangsdaten (siehe Konfiguration):

  • Dateien: Jede hochgeladene Datei geht direkt nach dem Speichern in den Bucket, gelöschte Dateien werden dort entfernt. uploads/ bleibt Arbeitskopie. Fehlt dort eine Datei – neuer Host, verlorenes Volume –, holt Flowplan sie aus dem Bucket: beim Abruf sofort, alle übrigen im Hintergrund.
  • Datenbank: Litestream überträgt Änderungen der SQLite-Datei etwa im Sekundentakt nach <Präfix>/db. Startet der Container ohne Datenbank, stellt Litestream sie zuerst aus dem Bucket wieder her.

Beim ersten Start mit S3 lädt Flowplan alle vorhandenen Dateien hoch. Den Fortschritt zeigt /api/health unter objectStorage.pending, die Verbindung und die Verteilung lokal/S3 die Administration → Betrieb.

Geeignet sind MinIO, Garage, SeaweedFS, AWS S3 und andere S3-kompatible Dienste.

Garage

Garage legt weder Bucket noch Schlüssel selbst an:

garage status                                  # Knoten-ID ablesen
garage layout assign -z dc1 -c 10G <Knoten-ID>
garage layout apply --version 1
garage bucket create flowplan
garage key create flowplan
garage bucket allow --read --write --owner flowplan --key flowplan
garage key info flowplan --show-secret         # Key-ID und Secret

S3_REGION muss dem Wert s3_region aus der garage.toml entsprechen.

SeaweedFS

Den S3-Dienst so starten, dass er auf allen Schnittstellen lauscht (-ip.bind=0.0.0.0), sonst ist er aus anderen Containern nicht erreichbar. Endpoint ist der S3-Port, standardmäßig 8333.

Sicherungen

  1. Instanzsicherung in Flowplan (empfohlen): Administration → Instanz → Sicherung der gesamten Instanz lädt Datenbank und Dateien konsistent im laufenden Betrieb herunter.
  2. S3 mit Litestream: laufende Sicherung; ein früherer Zeitpunkt lässt sich wiederherstellen (unten).
  3. Volume-Backup des Hosts oder in Coolify. Für eine konsistente Kopie den Container vorher stoppen.
  4. Von Hand im laufenden Betrieb:
sqlite3 /app/data/flowplan.sqlite "VACUUM INTO '/backup/flowplan.sqlite'"

Dazu uploads/ und web-push-keys.json mitsichern.

Das Inhaltsarchiv unter Einstellungen → Daten sichert einen Arbeitsbereich, ersetzt aber keine Instanzsicherung mit Konten und Rechten.

Wiederherstellen

  • Aus einer Instanzsicherung: in Administration → Instanz hochladen. Flowplan prüft sie und übernimmt sie beim nächsten Neustart; der vorherige Stand bleibt unter pre-restore-… im Datenverzeichnis.
  • Auf einem neuen Host mit S3: neue Installation mit denselben S3_*-Variablen und leerem Volume starten. Litestream stellt die Datenbank her, die Dateien folgen im Hintergrund.
  • Einen früheren Zeitpunkt bei gestoppter App:
litestream restore -config /etc/litestream.yml \
  -timestamp 2026-09-26T12:00:00Z -o /app/data/flowplan.sqlite

Vorher die bestehende flowplan.sqlite samt -wal und -shm beiseitelegen.

Kontingente

FLOWPLAN_WORKSPACE_QUOTA_MB oder Administration → Instanz legt ein Standard-Kontingent je Arbeitsbereich fest; unter Administration → Arbeitsbereiche lässt es sich je Arbeitsbereich überschreiben. Uploads, Kopien, Vorlagen und Importe über dem Kontingent werden abgelehnt.