Mit einem Klick bereitstellen

#Render

Bei Render bereitstellen → (öffnet in neuem Tab)

Der Button liest den Blueprint render.yaml (öffnet in neuem Tab) aus dem Repository: ein Webdienst aus dem Image ghcr.io/yannicschuller/flowplan:latest in Frankfurt, eine 5-GB-Disk auf /app/data und der Health Check auf /api/health.

Kosten: Dauerhafte Disks gibt es nur mit einer bezahlten Instanz – der Blueprint nimmt Starter, die kleinste mit Disk; die Disk wird zusätzlich pro GB abgerechnet (siehe Preise bei Render). Für mehr als eine Handvoll Personen wähl eine größere Instanz (Dimensionierung). Auf der kostenlosen Instanz gingen die Daten bei jedem Neustart verloren.

Adresse: Ohne APP_URL nimmt Flowplan Renders eigene Adresse (RENDER_EXTERNAL_URL, ersatzweise https:// mit RENDER_EXTERNAL_HOSTNAME). Für deine Domain trägst du sie unter Settings → Custom Domains ein und setzt unter Environment APP_URL=https://flowplan.example.com – am besten vor dem ersten Konto, denn Passkeys sind an die Adresse gebunden.

Daten und Updates: Alles liegt auf der Disk – einen Dienst mit Disk betreibt Render als genau eine Instanz und hält ihn bei jedem Deploy kurz an. Render hebt Snapshots der Disk auf; für Sicherungen außerhalb von Render kommt S3 dazu (Speicher, S3 und Sicherung). Zum Aktualisieren startest du einen Manual Deploy: Render holt das Image :latest neu.

#DigitalOcean App Platform

Bei DigitalOcean bereitstellen → (öffnet in neuem Tab)

Der Button liest .do/deploy.template.yaml (öffnet in neuem Tab): ein Dienst aus dem Image, eine PostgreSQL-16-Dev-Datenbank und der Health Check auf /api/health, in Frankfurt (fra).

App Platform hat keine dauerhaften Volumes: Die Disk des Containers wird bei jedem Deploy und Neustart zurückgesetzt. Deshalb nutzt die Vorlage PostgreSQL statt SQLite (DATABASE_URL zeigt auf die Datenbank) und erwartet einen Bucket für Dateien:

• Uploads: Leg einen Spaces-Bucket und einen Spaces-Zugangsschlüssel an und trag S3_BUCKET, S3_ACCESS_KEY_ID und S3_SECRET_ACCESS_KEY ein (S3_ENDPOINT ist für Frankfurt vorbelegt, https://fra1.digitaloceanspaces.com). Flowplan legt dann jede Datei in den Bucket und holt fehlende nach einem Deploy von dort zurück. Ohne Bucket gehen hochgeladene Dateien beim nächsten Deploy verloren.
• FLOWPLAN_SETUP_TOKEN (erzeugen mit openssl rand -hex 24): das erste Konto nur über <Adresse>/register?setup=<token>.
• FLOWPLAN_ENCRYPTION_KEY (erzeugen mit openssl rand -base64 32): verschlüsselt die Dateien im Bucket und schützt gespeicherte Geheimnisse wie API-Schlüssel. Er muss hier gesetzt sein, weil eine secrets.key auf der Disk des Containers bei jedem Deploy neu entstünde. Bewahr eine Kopie im Passwortmanager auf.
• Optional WEB_PUSH_PUBLIC_KEY und WEB_PUSH_PRIVATE_KEY (npx web-push generate-vapid-keys): Ohne sie entstehen bei jedem Deploy neue Schlüssel, und Push im Browser schweigt, bis man ihn wieder einschaltet. Push an die Apps ist davon nicht betroffen.

App Platform kann keine Geheimnisse selbst erzeugen, deshalb trägst du diese Werte beim Anlegen der App ein (oder später in den Settings → Environment Variables der Komponente). APP_URL ist App Platforms ${APP_URL}: die Adresse unter ondigitalocean.app oder deine Domain, sobald du sie unter Settings → Domains eingetragen hast – danach einmal neu deployen.

Datenbank: Eine Dev-Datenbank hat keine Sicherungen und ist zum Ausprobieren gedacht. Für den Betrieb rüstest du sie zu einem verwalteten Datenbank-Cluster auf oder hängst einen vorhandenen mit PostgreSQL 16 oder neuer an (PostgreSQL). Das Image bringt pg_dump und pg_restore mit, Flowplans eigene geplante Sicherungen laufen also auch mit PostgreSQL – mit Bucket landen sie dort (Speicher, S3 und Sicherung). Die Verbindung ist verschlüsselt; uselibpqcompat=true in DATABASE_URL akzeptiert DigitalOceans eigene Zertifizierungsstelle, so wie psql mit sslmode=require. Meldet das Log permission denied for schema public, darf die Rolle der Dev-Datenbank keine Tabellen anlegen – dann einen verwalteten Datenbank-Cluster nehmen, dort darf es der Eigentümer der Datenbank (Rolle ohne Superuser-Rechte).

Updates: Starte einen neuen Deploy (Actions → Force Rebuild and Deploy); App Platform holt das Image :latest neu.

#Jeder Server: cloud-init oder Installationsskript

Für einen virtuellen Server (VPS) mit Ubuntu 24.04 oder Debian 12 bei einem beliebigen Anbieter. Die meisten – Hetzner Cloud, Netcup, IONOS, DigitalOcean Droplets, Vultr, Scaleway, OVHcloud – nehmen beim Anlegen des Servers eine cloud-init-Datei als „User Data“ oder „Cloud Config“ an.

Auf einem Server, der schon läuft, erledigt das Installationsskript dasselbe:

curl -fsSL https://raw.githubusercontent.com/yannicschuller/flowplan/main/deploy/install.sh | sudo bash -s -- flowplan.example.com

Was das Skript einrichtet:

• Docker mit dem Compose-Plugin aus Dockers eigenem Paket-Repository (übersprungen, wenn es schon da ist).
• /opt/flowplan mit compose.yaml (Flowplan und Caddy (öffnet in neuem Tab), das sich das HTTPS-Zertifikat selbst holt und erneuert), dem Caddyfile und einer .env, die nur root lesen darf. Ihre Geheimnisse erzeugt openssl auf dem Server: FLOWPLAN_SETUP_TOKEN und FLOWPLAN_ENCRYPTION_KEY – bewahr eine Kopie des Schlüssels im Passwortmanager auf, verschlüsselte Sicherungen lassen sich ohne ihn nicht lesen.
• Die Daten im Docker-Volume flowplan-data. Sie überstehen Updates und Neustarts; für Sicherungen außerhalb des Servers kommt S3 oder SFTP dazu (Speicher, S3 und Sicherung).
• Firewall (ufw): Nur SSH, 80 und 443 bleiben offen. Auf einem Server mit eigener Firewall startest du das Skript mit FLOWPLAN_FIREWALL=off. Die Ports 80 und 443 müssen frei sein – belegt sie schon ein anderer Webserver, stell Flowplan stattdessen hinter ihn (Coolify und Reverse Proxys).
• Automatische Sicherheitsupdates des Systems (unattended-upgrades).
• Image-Updates sind anfangs aus: Du aktualisierst, wann es dir passt, mit cd /opt/flowplan && docker compose pull && docker compose up -d – die Administration meldet neue Releases. Für ein automatisches Update jede Woche (Sonntagnacht) setzt du FLOWPLAN_AUTO_UPDATE=weekly in der cloud-init-Datei (oder vor bash im Befehl) oder später systemctl enable --now flowplan-update.timer.

Ohne Domain (FLOWPLAN_DOMAIN= leer gelassen oder das Skript ohne Argument) startet Flowplan unter http://<Serveradresse> ohne Zertifikat – gut für einen Test, siehe Ohne HTTPS. Für eine Domain später den DNS-Eintrag auf den Server zeigen lassen und das Skript mit der Domain erneut ausführen: Es setzt APP_URL und das Caddyfile und behält Daten und Geheimnisse. Am besten vor dem ersten Konto, denn Passkeys sind an die Adresse gebunden.

Weitere Einstellungen (E-Mail, Single Sign-on, S3) gehören in /opt/flowplan/.env, danach docker compose up -d in /opt/flowplan – siehe Konfiguration.