So hostest Du AppFlowy selbst

Das Wichtigste auf einen Blick: Mit einer selbst gehosteten AppFlowy-Umgebung hast Du die volle Kontrolle über Deine Daten und kannst zwischen einer einfachen lokalen Installation oder einer Serverinstallation, wie ein SaaS, mit Fernzugriff wählen. Bei der Desktop-Methode werden alle Dateien auf Deinem Gerät gespeichert, während bei der Server-Methode Docker für den Zugriff über mehrere Geräte, die Authentifizierung und die zentrale Speicherung sorgt. Beide Ansätze bieten im Vergleich zu Managed Services mehr Privatsphäre.

Wenn Du Deine eigenen Produktivitäts-Tools verwaltest, hast Du die volle Kontrolle über Deine Daten, Anpassungen und Arbeitsabläufe. Die Open-Source-Plattform von AppFlowy macht das möglich und lässt Dich Deinen eigenen Arbeitsbereich hosten, ohne auf externe Cloud-Dienste angewiesen zu sein. Für alle, die sich um Datenschutz, Abhängigkeit oder ein vollständig anpassbares Setup sorgen, ist Selfhosting der richtige Weg.

In diesem Artikel werden wir zwei praktische Ansätze untersuchen: eine einfache lokale Installation für den persönlichen Gebrauch und eine vollständige Serverinstallation für robustere Setups, zusammen mit allem, was Du benötigst, um loszulegen und Deine Instanz reibungslos laufen zu lassen.

Was ist AppFlowy und warum ist Selfhosting wichtig?

AppFlowy ist eine Open-Source-Produktivitätsplattform, die Notizen, Datenbanken, Wikis und Projektmanagement in einem einzigen Arbeitsbereich zusammenführt. Dank des Open-Source-Designs kannst Du es auf Deiner eigenen Infrastruktur ausführen und hast so die volle Kontrolle über Deine Umgebung und Daten.

Durch Selfhosting behältst Du die vollständige Kontrolle über Deine Dokumente und Projekte. Du entscheidest, wer darauf zugreifen kann und wie sie gesichert werden. Du kannst zum Beispiel automatische lokale Backups einrichten, AppFlowy mit anderen Tools auf Deinem Server verbinden oder den Zugriff auf bestimmte Teammitglieder beschränken – Funktionen, die bei Cloud-Diensten nicht immer verfügbar sind. Das macht Selfhosting zu einer praktischen Wahl für alle, die sich Gedanken über Sicherheit, Abhängigkeit oder die Anpassung des Arbeitsbereichs an bestimmte Arbeitsabläufe machen.

Voraussetzungen für das Selfhosting von AppFlowy

Bevor Du AppFlowy einrichtest, solltest Du sicherstellen, dass Dein Setup die Anforderungen für die von Dir gewählte Hosting-Methode erfüllt:

Serverbasierte Bereitstellung

• Ein Rechner oder VPS mit mindestens 2 GB RAM (4 GB empfohlen).
• Öffne Netzwerkports, wenn Du externen Zugriff zulassen möchtest: HTTP (Port 80) und HTTPS (Port 443). Geschlossene oder blockierte Ports verhindern Verbindungen von außen.
• Grundlegende Kenntnisse in der Installation von Software und der Verwaltung von Servern.

Containerisierte Bereitstellung

• Eine funktionierende Installation von Docker und Docker Compose (Version 2 oder höher). Diese Tools verwalten die Komponenten von AppFlowy effizient und vereinfachen Updates.
• Grundlegende Erfahrung mit der Befehlszeile zum Ausführen von Containern und zur Fehlerbehebung.

Die Erfüllung dieser Voraussetzungen gewährleistet eine reibungslose Einrichtung und vermeidet häufige Fehler, die durch unzureichende Ressourcen oder falsch konfigurierten Zugriff verursacht werden.

Desktop-Installation (lokale Methode)

Schritt 1: AppFlowy Desktop herunterladen und installieren

Um AppFlowy auf einem einzelnen Computer zu verwenden, ohne Deine Daten online preiszugeben, lade zunächst die Desktop-Version herunter:

1. Besuche die offizielle Website von AppFlowy oder die GitHub-Release-Seite.
2. Wähle die Version aus, die zu Deinem Betriebssystem passt (Windows, macOS oder Linux).
3. Lade das Installationsprogramm (Windows/macOS) oder die Archivdatei (Linux) herunter.
4. Führe das Installationsprogramm aus oder extrahiere das Archiv und starte AppFlowy.

Tipps:

• Unter Linux musst Du möglicherweise vor dem Ausführen mit chmod +x Ausführungsrechte gewähren.
• Stelle sicher, dass Du von offiziellen Quellen herunterlädst, um manipulierte Dateien zu vermeiden.

Schritt 2: Erstkonfiguration

Wenn Du AppFlowy zum ersten Mal startest:

1. Wähle einen Speicherort auf Deinem Computer, um Deine Daten und Notizen zu speichern.

2. Überprüfe die Standardeinstellungen, wie z. B. das Design oder die Sprache, und passe sie bei Bedarf an.

Da diese Installation vollständig auf Deinem Rechner läuft, ist keine Serverkonfiguration oder Netzwerkeinrichtung erforderlich. Alle Daten bleiben lokal gespeichert, sodass Du die volle Kontrolle hast.

Schritt 3: AppFlowy lokal nutzen

Nach der Konfiguration kannst Du sofort mit dem Erstellen von Notizen, Datenbanken, Wikis oder Projekten beginnen. Da alles lokal gespeichert wird

• ist die Leistung schnell und zuverlässig.
• ist die Privatsphäre maximal geschützt, da kein externer Server beteiligt ist.

Einschränkungen

• Die lokale Installation bietet keine Gerätesynchronisation.
• Kollaborationsfunktionen sind nur verfügbar, wenn Du zu einer serverbasierten Einrichtung migrierst.

Diese Methode ist ideal für Personen, die Einfachheit, Geschwindigkeit und vollständige Kontrolle über ihre Daten wünschen. Wenn Du vorhast, von mehreren Geräten aus auf AppFlowy zuzugreifen oder Deine Arbeit mit einem Team zu teilen, solltest Du die serverbasierte Selfhosting-Methode in Betracht ziehen.

Serverbasierte Installation (Docker-Methode)

Die Ausführung von AppFlowy auf einem Server oder einer Workstation über Docker bietet eine flexible und wartungsfreundliche Einrichtung, die den Zugriff von mehreren Geräten und die Zusammenarbeit im Team ohne komplexe manuelle Konfiguration ermöglicht. Docker-Container bündeln alle Abhängigkeiten, wodurch die Bereitstellung konsistent und einfacher zu verwalten ist.

Schritt 1: Installiere Docker und Docker Compose

1. Lade Docker Desktop für Windows oder macOS oder Docker Engine für Linux herunter und installiere es.

2. Stell sicher, dass Docker Compose (Version 2 oder höher) installiert ist; das wird zur Verwaltung von Multi-Container-Setups verwendet.

Öffne ein Terminal oder Docker Desktop und überprüfe die Installation:

docker --version

docker-compose --version

3. Beide Befehle sollten Versionsnummern zurückgeben.

Wenn einer dieser Befehle fehlt, führe diesen Befehl aus:

Für Linux:

1. Installiere Docker Engine gemäß den Anweisungen Deiner Distribution (z. B. Ubuntu: sudo apt install docker.io).

2. Installiere Docker Compose (Version 2 oder höher). Unter Ubuntu kannst Du Folgendes verwenden:

sudo apt install docker-compose-plugin

Schritt 3: Klone das AppFlowy Cloud-Repository

Anstatt ein einzelnes Docker-Image abzurufen, musst Du für AppFlowy Cloud das offizielle Repository klonen, das die komplette Docker-Compose-Konfiguration enthält:

git clone https://github.com/AppFlowy-IO/AppFlowy-Cloud.git

cd AppFlowy-Cloud

Dieses Repository enthält alle notwendigen Konfigurationsdateien, das Docker Compose-Setup und Umgebungsvorlagen für die Ausführung des kompletten AppFlowy Cloud-Stacks.

Schritt 4: Konfiguriere die Umgebungseinstellungen

1. Kopiere die Standard-Umgebungskonfigurationsdatei:

cp deploy.env .env

nano .env

(Optional) Wenn die Ports 80 oder 443 schon von einem anderen Dienst (wie Nginx oder Apache) genutzt werden, bearbeite die .env-Datei, um die Port-Bindungen zu ändern:

Bearbeite .env und ändere diese Zeilen:

NGINX_PORT=8080 # Ändere den Standardwert 80

NGINX_TLS_PORT=8443 # Ändere den Standardwert 443

Wichtiger Sicherheitshinweis: Bevor Du diese Bereitstellung im Internet verfügbar machst, ändere die Standard-Anmeldedaten für Administratoren in der .env-Datei:

GOTRUE_ADMIN_EMAIL=deine-email@beispiel.com

GOTRUE_ADMIN_PASSWORD=dein-sicheres-Passwort

Schritt 5: Starte die AppFlowy Cloud Services

1. Starte alle Dienste mit Docker Compose:

docker compose up -d

Dieser Befehl startet mehrere Container, darunter:

• nginx – Reverse-Proxy und Webserver
• postgres – Datenbank zum Speichern aller Daten
• redis – Caching-Ebene
• gotrue – Authentifizierungsdienst
• appflowy_cloud – Backend-API-Server
• admin_frontend – Admin-Konsolen-Schnittstelle

2. Überprüfe, ob alle Dienste laufen und in Ordnung sind:

docker compose ps

Alle Dienste sollten den Status „running” oder „healthy” anzeigen.

Schritt 6: Öffne die Admin-Konsole

Öffne einen Browser und geh zu:

• Lokaler Zugriff: http://localhost/console (oder http://localhost:8080/console, wenn Du den Port geändert hast)
• Fernzugriff: http://YOUR_SERVER_IP/console

Melde Dich mit den Admin-Anmeldedaten an (Standard oder die, die Du in .env festgelegt hast):

• E-Mail: deine-email@beispiel.com
• Passwort: dein-sicheres-Passwort

Schritt 7: Benutzerkonten erstellen

Da AppFlowy-Clients keine direkte passwortbasierte Registrierung unterstützen, musst Du Benutzer über die Admin-Konsole erstellen:

1. Klick in der Admin-Konsole auf die Schaltfläche „Admin“ (oben rechts)
2. Geh zum Abschnitt „Benutzer“
3. Klick auf „Benutzer erstellen“ und gib Folgendes ein:

• E-Mail-Adresse (muss nicht echt sein, außer Du verwendest SMTP (Simple Mail Transfer Protocol))
• Passwort

4. Klicke auf „Erstellen“

Schritt 8: AppFlowy-Desktop-Client konfigurieren

So verbindest Du Deine Desktop-Anwendung mit Deinem selbst gehosteten Server:

1. Lade die AppFlowy-Desktop-App von appflowy.com herunter und installiere sie.
2. Starte die App und gehe zum Anmeldebildschirm.
3. Klick auf das Einstellungen-Symbol unten auf der Anmeldeseite.
4. Aktualisiere die Basis-URL wie folgt:

• Lokal: http://localhost (oder Dein benutzerdefinierter Port wie http://localhost:8080)
• Fernzugriff: http://YOUR_SERVER_IP

5. Schließ die AppFlowy-Anwendung und starte sie neu.
6. Melde Dich mit den Anmeldedaten an, die Du in der Admin-Konsole erstellt hast.
7. Klick auf „Open AppFlowy”, um den mit Deinem Server verbundenen Desktop-Client zu starten.

Tipps und Hinweise:

• Stell sicher, dass Deine Server-Firewall die Ports 80 und 443 für den externen Zugriff zulässt.
• Für den produktiven Einsatz solltest Du Deinen Server mit HTTPS-Zertifikaten (z. B. Let’s Encrypt) sichern.
• Mach regelmäßig Backups vom Ordner „appflowy-data“, um Datenverlust zu vermeiden.
• Das Aktualisieren des Containers ist ganz einfach: Zieh einfach das neue Image und starte den Container neu.

Grundlegende VPS-Verwaltung

Jetzt, wo Deine AppFlowy-Instanz läuft, sorgt eine ordentliche Serververwaltung für Zuverlässigkeit und Sicherheit.

Hier sind wichtige Anleitungen, die Dir bei der Wartung und Sicherung Deines VPS helfen:

Erste Schritte mit Deinem Server

1. So verbindest Du Dich mit SSH mit dem VPS: Greife von überall sicher auf Deinen Server zu
2. So setzt Du Ubuntu VPS auf die Werkseinstellungen zurück: Starte neu, wenn Du eine Neuinstallation benötigst

Sicherheit und Überwachung

1. So installierst Du SSL auf dem VPS: Sichere Deine AppFlowy-Instanz mit HTTPS-Verschlüsselung
2. So überwachst Du den Netzwerkverkehr auf einem VPS: Verfolge die Bandbreitennutzung und erkenne Probleme
3. So überwachst Du die Verfügbarkeit des VPS-Servers: Stelle sicher, dass Dein Arbeitsbereich zugänglich bleibt

Erweiterte Konfiguration

1. So verwaltest Du Ports auf dem VPS: Konfiguriere Firewall-Regeln und Netzwerkzugriff

Weitere Infos zur Auswahl des richtigen VPS für Deine Anforderungen findest Du unter unserem VPS-Hosting-Service.

Sicherheit und Wartung

Sicherheit

Wenn Du Deine eigene AppFlowy-Instanz betreibst, musst Du sowohl Deinen Server als auch Deine Daten schützen. Setze HTTPS mit SSL/TLS-Zertifikaten durch, um Daten während der Übertragung zu verschlüsseln. Verwende starke, eindeutige Anmeldedaten für alle Konten und erwäge, öffentliche Anmeldungen zu deaktivieren, sobald der Server live ist, um unbefugten Zugriff zu verhindern. Beschränke den Serverzugriff nach Möglichkeit auf vertrauenswürdige IPs.

Datensicherungen

Sichere regelmäßig Deine Datenbank und alle angehängten Dateien, wie Notizen oder Medien. Automatisierte Skripte, Container-Backup-Dienstprogramme oder Cron-Jobs können dabei helfen, sicherzustellen, dass Backups regelmäßig durchgeführt werden. Überprüfe regelmäßig, ob Deine Backups vollständig und wiederherstellbar sind.

Wartung

Halte Deine AppFlowy-Installation auf dem neuesten Stand, indem Du regelmäßig Docker-Images aktualisierst oder aus dem Quellcode neu kompilierst, um Sicherheitspatches anzuwenden. Überwache Serverprotokolle, Datenbanknutzung und Dateispeicher (wie MinIO), um Leistungsengpässe zu vermeiden. Plane zusätzliche Ressourcen ein, wenn Dein Arbeitsbereich wächst, um die Reaktionsfähigkeit aufrechtzuerhalten.

Einschränkungen und bekannte Probleme mit selbst gehostetem AppFlowy

Einrichtung und Wartung

Selfhosting bietet Kontrolle und Flexibilität, erfordert jedoch Aufwand. Im Gegensatz zu einem managed SaaS bist Du für Updates, Backups und die Serverwartung verantwortlich. Gelegenheitsnutzer könnten die laufende Verwaltung als anspruchsvoller empfinden als erwartet.

Technische und funktionale Probleme

Einige Nutzer berichten von gelegentlichen Störungen, wie z. B. Problemen bei der Web-Synchronisierung und Inkonsistenzen in der Benutzeroberfläche, wenn Docker Compose verwendet wird, um das Cloud-Backend mit der Web-Benutzeroberfläche zu kombinieren. Die Anmeldung über Magic-Link kann in bestimmten Hostings fehlschlagen, und die Web-Benutzeroberfläche leitet nach der Authentifizierung manchmal nicht richtig weiter. Prüfe hier ggf. die Firewalleinstellungen auf deinem Server.

Einschränkungen bei der Zusammenarbeit

Die Funktionen für die Zusammenarbeit in Echtzeit können eingeschränkt oder weniger stabil sein als die des gehosteten Dienstes von AppFlowy. Teams, die auf synchrone Bearbeitung angewiesen sind, sollten sich potenziellen Verzögerungen oder Inkonsistenzen bewusst sein.

Fazit

Mit dem selbst gehosteten AppFlowy hast Du die volle Kontrolle über Deinen Arbeitsbereich und Deine Daten. Die Desktop-Installation bietet eine einfache, private Einrichtung für die Nutzung auf einem einzelnen Gerät, während eine serverbasierte Bereitstellung den Zugriff über mehrere Geräte, die Remote-Zusammenarbeit und die zentrale Speicherung unterstützt. Obwohl das Selfhosting mit technischem Aufwand und laufender Wartung verbunden ist, machen die Vorteile, die verbesserte Privatsphäre, Unabhängigkeit und Anpassungsmöglichkeiten es zu einer starken Alternative zu Closed-Source-SaaS-Plattformen. Für Nutzer und Teams, die Wert auf Kontrolle und Eigentumsrechte legen, ist der Betrieb einer eigenen AppFlowy-Instanz eine praktische und lohnende Lösung.

Artikel von

Frederick Schiwek

Hallo! Ich bin Freddy, Autor und Mitglied des Teams von hosting.de. Mit über 20 Jahren Erfahrung im Hosting-Business schreibe ich über Technologie, das Internet und die Zukunft der digitalen Infrastruktur. Ob Domains, Hosting oder Cloud-Dienste – ich bin hier, um Einblicke und Ideen zu teilen!