SSD Nodes Learn Hosting plans →
Anleitungen Matt ConnorVon Matt Connor · Aktualisiert 2026-11-06

Dify mit Docker Compose auf einem VPS selbst hosten

Dify startet mit 15 Containern und benötigt mindestens 4 GiB RAM. Ändern Sie die Standardpasswörter in .env und sichern Sie /install vor dem ersten Zugriff.

Was Dify ist und was Sie damit betreiben

Dify ist eine Plattform, die Sie selbst hosten können, um Anwendungen auf Basis großer Sprachmodelle zu erstellen. Sie erhalten eine Weboberfläche zum Entwerfen von Chat-Anwendungen, Agents und Retrieval-Pipelines, eine API für Aufrufe aus Ihrem eigenen Code sowie eine zentrale Verwaltung für Prompts, Datensätze und Model-Keys. Ein kleines Team kann damit auf einer gemeinsamen privaten Grundlage arbeiten, statt API-Keys über mehrere Skripte zu verteilen. Falls Begriffe wie Agent, Tool-Aufruf und Retrieval-Pipeline noch unklar sind, hilft es, diese Konzepte zunächst von Grund auf durchzuarbeiten. Danach wirken Dify's Builder-Oberflächen wie verständliche Steuerelemente und nicht wie eine Wand unbeschrifteter Schalter.

Wenn Sie Dify selbst betreiben, müssen Sie zahlreiche Komponenten ausführen. Im Oktober 2026 startet der dokumentierte Standard-Stack von Dify 15 dauerhaft laufende Container sowie einen einmaligen Task, der Dateiberechtigungen setzt und anschließend beendet wird. Sieben davon sind eigene Dify-Dienste: der API-Server, ein WebSocket-Server, ein Hintergrund-Worker, ein Scheduler, das Web-Frontend, ein Plugin-Daemon und ein Agent-Backend. Die übrigen acht sind Abhängigkeiten: eine Postgres-Datenbank, ein Redis-Cache, eine Weaviate-Vektordatenbank, ein Nginx-Frontend, zwei Code-Sandboxen und zwei SSRF-Proxys. Docker Compose verbindet alle Komponenten miteinander. Das ist jedoch ein echter Stack, und Dify nennt als Mindestanforderung 4 GiB RAM und zwei CPU-Kerne. Wenn auf dieser VPS zusätzlich andere Dienste laufen sollen, dimensionieren Sie sie anhand gemessener Werte und nicht anhand beworbener Angaben. PhotoPrism und Immich benötigen eigenen Arbeitsspeicher, und ein Fotoserver auf demselben Host konkurriert mit Dify's Datenbank und Vektorspeicher. CPU-Konkurrenz wirkt sich genauso aus: Eine Jellyfin-Bibliothek im Design einer Videothek aus den 90er-Jahren benötigt beim bloßen Durchsuchen der Cover fast keine Ressourcen. Sobald jedoch jemand eine Transkodierung startet, muss Dify's Worker hinter dieser Last warten. Der Vorteil ist, dass die Anzahl der Dify-Container unabhängig von der Zahl Ihrer Anwendungen konstant bleibt. Das führt zu einer besser kalkulierbaren Belastung als bei OpenBot, bei dem jeder KI-Mitarbeiter seinen eigenen Container und seinen eigenen Browser erhält und jeder neue Mitarbeiter den erforderlichen Arbeitsspeicher weiter erhöht.

Da Dify Ihre Model-API-Keys und häufig auch private Dokumente enthält, die Sie für Retrieval geladen haben, sollten Sie den Host bereits ab der ersten Minute als schützenswert behandeln. Dieser Leitfaden installiert Dify und härtet es anschließend so ab, wie Sie jeden Dienst mit vertraulichen Daten härten würden.

Voraussetzungen

Sie benötigen einen VPS mit Ubuntu 24.04, mindestens 4 GiB RAM und zwei CPU-Kernen, Docker mit installiertem Docker-Compose-Plugin (Dify erfordert Compose 2.35.0 oder höher) sowie einen Benutzer mit sudo oder als Mitglied der Gruppe docker. Der folgende Clone-Befehl verwendet außerdem git, curl und jq. Wenn Docker für Sie neu ist, erläutert die Grundlagen von Docker Compose auf einem VPS die Installation und die grundlegenden Befehle, die in dieser Anleitung vorausgesetzt werden. Ein auf den Server zeigender Domainname ist empfehlenswert, weil Sie Dify über TLS und nicht über eine unveränderte IP-Adresse bereitstellen sollten.

Schritt 1: Dify und die Compose-Dateien abrufen

Dify verwaltet seine Docker-Konfiguration im Haupt-Repository. Klonen Sie das neueste Release, nicht den Entwicklungs-Branch, und wechseln Sie in das Docker-Verzeichnis:

git clone --branch "$(curl -s https://api.github.com/repos/langgenius/dify/releases/latest | jq -r .tag_name)" https://github.com/langgenius/dify.git
cd dify/docker
cp .env.example .env

Wenn das Klonen mit dem Fehler „Remote branch null“ fehlschlägt, hat die Abfrage an die GitHub-API kein Ergebnis geliefert. Wählen Sie auf der Release-Seite eine Version aus und übergeben Sie sie manuell an --branch.

Die Datei .env enthält die zentrale Konfiguration. Lesen Sie sie, bevor Sie etwas starten. Zuerst sind die Werte relevant, die Passwörter und Secrets festlegen: SECRET_KEY, das Postgres-Passwort und das Redis-Passwort. SECRET_KEY wird leer ausgeliefert. Wenn Sie diesen Wert unverändert lassen, generiert Dify einen Schlüssel und speichert ihn in seinem Speicherverzeichnis. Bei den Passwörtern ist die Situation anders: Die mitgelieferten Standardwerte unter envs/ verwenden dasselbe difyai123456 für Postgres und Redis sowie feste, öffentlich bekannte Schlüssel für die Code-Sandbox, den Plugin-Daemon, Weaviate und das Agent-Backend. Die aktuelle .env.example enthält nur die Standard-Compose-Profile und das erforderliche Agent-Sandbox-Token. Fügen Sie Ihre eigenen Zugangsdaten in .env ein. Wenn Sie lieber einen eigenen Secret Key festlegen möchten, generieren Sie einen:

openssl rand -base64 42

Fügen Sie ihn in SECRET_KEY ein und ergänzen Sie starke, eindeutige Werte für DB_PASSWORD, REDIS_PASSWORD, PLUGIN_DAEMON_KEY und PLUGIN_DIFY_INNER_API_KEY. Setzen Sie SANDBOX_API_KEY und CODE_EXECUTION_API_KEY auf dasselbe separate Secret. Setzen Sie WEAVIATE_API_KEY und WEAVIATE_AUTHENTICATION_APIKEY_ALLOWED_KEYS auf dasselbe separate Secret und setzen Sie WEAVIATE_AUTHENTICATION_ANONYMOUS_ACCESS_ENABLED=false. Das Standard-CELERY_BROKER_URL leitet sein Passwort jetzt aus REDIS_PASSWORD ab. Wenn Sie die URL ausdrücklich überschreiben, aktualisieren Sie auch das zugehörige Passwort.

Generieren Sie mit openssl rand -base64 32 ein separates Token und setzen Sie DIFY_AGENT_LOCAL_SANDBOX_AUTH_TOKEN in .env, bevor Sie den Stack starten. Ohne dieses Token starten das Agent-Backend und seine Sandbox nicht. Ersetzen Sie außerdem DIFY_AGENT_API_TOKEN durch ein separates zufälliges Token und setzen Sie DIFY_AGENT_SERVER_SECRET_KEY auf einen ungepolsterten base64url-Wert, der beim Decodieren genau 32 Bytes ergibt und mit openssl rand -base64 32 | tr '+/' '-_' | tr -d '=' generiert wurde.

Schritt 2: Starten

Starten Sie den Stack:

docker compose up -d

Beim ersten Start werden mehrere Images abgerufen und die Datenbank initialisiert. Warten Sie daher eine Minute. Prüfen Sie, ob die Container fehlerfrei laufen:

docker compose ps

Jeder dauerhaft laufende Dienst sollte running lesen. Der einmalige Berechtigungs-Task wird beendet, sobald er seine Aufgabe abgeschlossen hat. Dify stellt seine Weboberfläche standardmäßig über einen integrierten nginx-Container auf Port 80 bereit. Beim ersten Aufruf von http://YOUR_SERVER/install erstellen Sie das Administratorkonto. Führen Sie diesen Schritt sofort aus, bevor etwas anderes den Port erreichen kann. Solange dieses Konto nicht existiert, kann jeder, der die Seite lädt, es für sich beanspruchen und Ihre Instanz übernehmen.

Für die Echtzeit-Zusammenarbeit über einen entfernten Browser setzen Sie NEXT_PUBLIC_SOCKET_URL in .env auf die WebSocket-Adresse Ihres Servers. Verwenden Sie dabei wss:// mit HTTPS. Führen Sie anschließend docker compose up -d aus.

Schritt 3: Nicht ungeschützt veröffentlichen. TLS und eine Firewall vorschalten

Hier enden die meisten schnellen Installationen, und hier beginnen die meisten Vorfälle. Der eigene nginx von Dify lauscht auf Port 80 unverschlüsselt auf allen Schnittstellen und veröffentlicht außerdem Port 443. Ihre Administratoranmeldung und Ihre Modellschlüssel sollen nicht über unverschlüsseltes HTTP übertragen werden. Außerdem sollen die internen Dienste nicht von außen erreichbar sein.

Sichern Sie den Server mit einer Firewall nach dem Prinzip „standardmäßig verweigern“, die nur SSH- und Webverkehr zulässt:

sudo ufw default deny incoming
sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable

Beachten Sie, dass eine Firewall, die nur IPv4 abdeckt, dieselben Ports unter IPv6 offen lassen kann. Diese IPv6-Firewall-Lücke betrifft viele Self-Hosting-Installationen. Vergewissern Sie sich, dass beide Protokollstapel gefiltert werden. Beachten Sie außerdem, dass von Docker veröffentlichte Ports durch die eigenen Firewall-Regeln von Docker und nicht durch die Regeln von ufw verarbeitet werden. Der Standard-Stack veröffentlicht den Debugging-Port des Plugin-Daemons, 5003, auf allen Schnittstellen. Lassen Sie EXPOSE_PLUGIN_DEBUGGING_PORT=5003 in .env unverändert: Dieser Wert wird auch an PLUGIN_REMOTE_INSTALL_PORT übergeben, das eine Ganzzahl erwartet. Dadurch verhindert 127.0.0.1:5003 den Start der API. Binden Sie den Dienst stattdessen in docker-compose.override.yaml an die Loopback-Schnittstelle. Erstellen Sie mit Docker Compose 2.24.4 oder höher diese Datei im Verzeichnis docker:

services:
  plugin_daemon:
    ports: !override
      - "127.0.0.1:5003:5003"

Der Tag !override ersetzt die ursprüngliche öffentliche Zuordnung. Eine gewöhnliche ports-Liste würde diese beibehalten. Führen Sie docker compose up -d aus, um die Änderung anzuwenden.

Für TLS besteht der sauberste Weg darin, Dify's Webport an die Loopback-Schnittstelle zu binden und davor einen Reverse Proxy mit einem Let's-Encrypt-Zertifikat zu betreiben. Im öffentlichen Internet ist dann nur der Proxy erreichbar, der HTTPS spricht. Mit .env von Dify können Sie den veröffentlichten Port ändern. Setzen Sie ihn so, dass er an 127.0.0.1 gebunden wird, und richten Sie den Proxy auf diesen Port. Verfahren Sie ebenso mit EXPOSE_NGINX_SSL_PORT, da Dify's nginx standardmäßig den Host-Port 443 belegt und Ihr Proxy ihn benötigt. Die Hinweise zur Absicherung von Agenten in einen AI-Agent sicher auf einem VPS betreiben gelten auch hier: Halten Sie die beteiligten Komponenten an die Loopback-Schnittstelle gebunden, veröffentlichen Sie nur zwingend erforderliche Dienste und lassen Sie einen einzigen gehärteten Zugangspunkt TLS sprechen. Wenn eine Schnittstelle nur für Sie bestimmt ist und überhaupt kein Zertifikat benötigt, verzichten Sie auf den Proxy und greifen Sie über einen SSH-Tunnel darauf zu. So hält den open-kritt-Sicherheitsscanner selbst hosten sein Dashboard an die Loopback-Schnittstelle gebunden und leitet es stattdessen an Ihren Laptop weiter, anstatt es zu veröffentlichen. Wenn ein ganzes Team Dify benötigt, der öffentliche Zugriff aber nicht erforderlich ist, lässt sich dieses Konzept mit einem Overlay-Netzwerk über einen einzelnen Laptop hinaus skalieren: das private Subnetz des Servers für Ihr Tailnet bekannt machen ermöglicht jedem freigegebenen Gerät, den Builder über eine private Adresse zu erreichen, während die Firewall weiterhin alles außer SSH blockiert. Wenn Sie diesen Server über einen Coding-Agenten statt manuell verwalten, legen Sie fest, wie viel dieser unbeaufsichtigt ausführen darf, bevor Sie ihm die Zugriffsschlüssel überlassen. Denn der Berechtigungsmodus, in dem Sie Claude Code belassen bestimmt, ob der Agent vor dem Überschreiben von .env oder dem Neustart des Stacks nachfragt. Wenn eine Sitzung gerade Container-Logs verfolgt, während eine andere die Proxy-Konfiguration bearbeitet, können diese beiden Sitzungen Text auf demselben Server austauschen. Das ist effizienter, als bei jedem Neustart des Stacks Ausgaben zwischen Terminals zu kopieren.

Schritt 4: Halten Sie das System aktuell

Dify entwickelt sich schnell weiter, und Updates enthalten Sicherheitskorrekturen. Da Sie einen Release-Tag geklont haben, bedeutet eine Aktualisierung, den nächsten Tag auszuchecken, statt einen Branch zu aktualisieren. Sichern Sie zuerst die Datenbank. Führen Sie anschließend im Verzeichnis docker Folgendes aus:

docker compose stop -t -1
git fetch --tags
git checkout NEW_VERSION
docker compose pull
docker compose up -d

Datenbankmigrationen werden beim Start automatisch ausgeführt. Einige davon lassen sich nicht rückgängig machen. Deshalb wird die Sicherung zuerst erstellt. Lesen Sie vor jedem Upgrade die Release Notes, nicht nur vor größeren Upgrades. Dify weist darauf hin, dass sich die Upgrade-Schritte zwischen Releases unterscheiden. Die Hinweise zu 1.17.1 vom September 2026 nennen beispielsweise für Installationen mit dem gebündelten Weaviate und vorhandenen Daten, dass nicht direkt auf diese Version aktualisiert werden soll. Stattdessen muss Weaviate schrittweise über jedes Minor-Release aktualisiert werden. Dify ändert außerdem das Konfigurationsschema zwischen den Releases. Vergleichen Sie daher nach dem Auschecken eines neuen Tags .env.example mit Ihrer .env sowie die einzelnen lokalen Service-Dateien .env mit den jeweils gebündelten Vorlagen. Eine neue Variable, die Sie nicht gesetzt haben, kann sonst verhindern, dass ein Container startet. Verwenden Sie beim Upgrade weiterhin denselben Compose-Projektnamen und dieselben benutzerdefinierten Compose-Dateien, damit die benannten Volumes zugeordnet bleiben.

Schritt 5: Sichern Sie, was sich nicht neu erzeugen lässt

Sichern Sie die Postgres-Datenbank, in der Ihre Anwendungen, Benutzer und Einstellungen gespeichert sind, zusammen mit den hochgeladenen Dokumenten in volumes/app/storage und dem Vektorindex in volumes/weaviate. Dabei handelt es sich um separate per Bind-Mount eingebundene Verzeichnisse unter dem Verzeichnis docker, nicht um ein gemeinsames Volume. Bewahren Sie außerdem .env, lokale .env-Dateien des Dienstes unter envs/, benutzerdefinierte Compose-Dateien, den Plugin-Speicher sowie die benannten Volumes für Home-Verzeichnis und Arbeitsbereich der Agent-Sandbox auf. Erstellen Sie diese Snapshots nach einem festen Zeitplan und kopieren Sie sie vom Server weg. Stoppen Sie den Stack vor dem Kopieren der Datenbankdateien mit docker compose stop -t -1, oder verwenden Sie für ein Live-Backup die eigenen Dump-Werkzeuge der Datenbanken. Diese Backups enthalten Secrets und hochgeladene Dokumente. Verschlüsseln Sie sie daher, bevor sie den Server verlassen. Der Grund ist derselbe wie bei einem Vaultwarden-Backup, das sich als Schwachstelle eines ansonsten soliden Passwortservers erweist. Einen Model-API-Key können Sie neu ausstellen. Die Anwendung, in deren Entwicklung Sie eine Woche investiert haben, können Sie nicht einfach neu ausstellen. Dieselbe Überlegung gilt für jeden Agenten, dessen Zustand die Maschine überdauern muss, auf der er ausgeführt wird: KiroCrew als dauerhaft laufenden Container zu betreiben bedeutet letztlich, den Speicher und die Zeitpläne zu snapshotten, die andernfalls beim nächsten Reboot verloren gingen.

Wenn die Agenten, die Sie hier erstellen, über Ihre eigenen Datensätze hinaus auf das Live-Web zugreifen und darin suchen sollen, sorgt die Anbindung an eine selbst gehostete SearXNG-Instanz dafür, dass der Abfragestrom auf Hardware bleibt, die Sie kontrollieren. Lesen Sie sich jedoch zunächst in die dadurch entstehende Angriffsfläche für Prompt-Injection ein. Einen autonomeren Agenten, der Code ausführt, finden Sie unter Self-Hosting von Agent Zero. Die Grundlagen für alle diese Varianten behandelt das Erstellen eines eigenen AI-Agenten auf einem VPS.

FAQ

Welche Systemanforderungen gelten für das Self-Hosting von Dify?

Dify nennt mindestens 4 GiB RAM und zwei CPU-Kerne sowie Docker Compose 2.35.0 oder neuer. Dieser Mindestwert ergibt sich aus der Größe des Standard-Stacks: 15 dauerhaft laufende Container und eine einmalige Initialisierungsaufgabe (Stand Oktober 2026). Planen Sie außerdem ausreichend Speicherplatz für Ihre hochgeladenen Dokumente und den Vektorindex ein. Wenn weitere Dienste auf dem Server laufen, benötigen Sie zusätzlichen Arbeitsspeicher.

Ist es sicher, Dify direkt über Port 80 bereitzustellen?

Nein. Der mitgelieferte Webserver von Dify lauscht über unverschlüsseltes HTTP und stellt sowohl die Admin-Anmeldung als auch Ihre Model-API-Schlüssel bereit. Schalten Sie einen Reverse Proxy mit einem Let's-Encrypt-Zertifikat davor, binden Sie den von Dify verwendeten Port an die Loopback-Schnittstelle und lassen Sie nur den HTTPS-Proxy aus dem Internet erreichbar sein. Ergänzen Sie dies durch eine standardmäßig blockierende Firewall, die sowohl IPv4 als auch IPv6 abdeckt.

Wie aktualisiere ich ein selbst gehostetes Dify?

Sichern Sie zunächst die Datenbank. Führen Sie anschließend im Verzeichnis docker docker compose stop -t -1, git fetch --tags, git checkout, das neue Release-Tag, docker compose pull und docker compose up -d aus. Lesen Sie vorher die Release Notes, weil sich die Aktualisierungsschritte zwischen Releases unterscheiden, Migrationen irreversibel sein können und Dify gelegentlich neue .env-Variablen hinzufügt. Fehlt eine davon, kann ein Container möglicherweise nicht starten.

Was sollte ich nach der Installation von Dify als Erstes tun?

Rufen Sie /install auf und erstellen Sie sofort das Admin-Konto. Solange dieses Konto nicht existiert, kann es jeder übernehmen, der die Seite erreicht. Richten Sie das Konto ein, sobald die Container fehlerfrei laufen, und bevor Sie die Firewall für das Internet öffnen.

War dieser Artikel hilfreich?