Run This Ai
EN DE

Dify unter Ubuntu 24.04 installieren

A step-by-step installation guide.

So installieren Sie Dify auf Ubuntu 24.04

So installieren Sie Dify auf Ubuntu 24.04

Dify ist die führende Open-Source-Plattform für LLM-Anwendungen — erstellen Sie visuelle RAG-Pipelines, Agenten-Workflows und KI-Chatbots per Drag-and-Drop. Verbinden Sie ein beliebiges LLM, binden Sie Wissensdatenbanken ein und stellen Sie alles per API bereit. Diese Anleitung beschreibt die Self-Hosted-Installation auf Ubuntu 24.04 unter Verwendung von Docker.

Voraussetzungen

  • CPU: Mindestens 2 Kerne (4 empfohlen)
  • RAM: Mindestens 4 GB (8 GB empfohlen)
  • Festplatte: 10 GB freier Speicherplatz (20 GB+ für Embeddings)
  • Betriebssystem: Ubuntu 24.04 LTS
  • Docker + Docker Compose (v2.20+)
  • Git und sudo-Zugriff

Schritt 1 — Docker installieren (falls nicht vorhanden)

curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USER
newgrp docker
docker --version && docker compose version

Schritt 2 — Bereitstellung mit Docker Compose

git clone https://github.com/langgenius/dify.git
cd dify/docker
cp .env.example .env
docker compose up -d

Nach dem Start: Web-UI unter http://IHRE_IP:3001, API unter http://IHRE_IP:3000 (Image: langgenius/dify:latest).

Schritt 3 — Umgebungsvariablen

Bearbeiten Sie die Datei dify/docker/.env vor dem ersten Start:

  • SECRET_KEY — Schlüssel zur Sitzungsverschlüsselung. Generieren Sie diesen mit openssl rand -base64 42. Nach der Einrichtung niemals ändern — dies macht alle Sitzungen ungültig.
  • INIT_PASSWORD — Administrator-Passwort für die Initialisierung beim ersten Start.
  • LOG_LEVEL — INFO, WARNING oder ERROR. Verwenden Sie WARNING in der Produktion.

LLM-Anbieter

Fügen Sie API-Schlüssel unter Einstellungen → Modell-Anbieter hinzu. Unterstützt OpenAI, Azure, Anthropic, Gemini, Ollama und viele weitere.

RAG-Konfiguration

Legen Sie das Embedding-Modell (z. B. text-embedding-3-small via OpenAI oder lokal via Ollama) und optional das Rerank-Modell (Cohere, BAAI/bge-reranker, Jina) unter „Einstellungen → Modell-Anbieter“ fest.

Embedding- und Rerank-Modelle können für jede Wissensdatenbank individuell für verschiedene Datensätze konfiguriert werden.

Schritt 4 — Nginx Reverse Proxy (Gleiche Domain)

Web-UI und API über eine gemeinsame Domain bereitstellen:

server {
    listen 80;
    server_name dify.ihredomain.de;
    location / {
        proxy_pass http://127.0.0.1:3001;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
    location /api/ {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

Aktivieren Sie HTTPS mit: sudo certbot --nginx -d dify.ihredomain.de.

Schritt 5 — Backup

docker exec dify-db-1 pg_dump -U dify dify > dify_$(date +%F).sql
tar -czf dify_storage_$(date +%F).tar.gz ./dify/docker/volumes

Schritt 6 — Update

cd dify && git pull && docker compose up -d --pull always && docker image prune -f

Überprüfen Sie vor dem Upgrade die GitHub-Releases auf mögliche Breaking Changes.

Schritt 7 — Standard-Admin-Passwort ändern

Gehen Sie nach der ersten Anmeldung zu Einstellungen → Konto → Sicherheit und legen Sie ein starkes Passwort fest (mindestens 8 Zeichen, Groß-/Kleinschreibung und Zahlen).

Fehlerbehebung

Port-Konflikte (5432/6379): PostgreSQL und Redis belegen diese Ports. Ändern Sie die Zuordnung in der docker-compose.yml: db → ports: "5433:5432", redis → ports: "6380:6379".

Änderungen am SECRET_KEY unterbrechen Sitzungen: Eine Änderung nach der ersten Bereitstellung meldet alle Benutzer ab. Einmal festlegen und niemals ändern.

Datenbank-Migration schlägt fehl: Führen Sie docker compose run --rm api flask db upgrade manuell aus und starten Sie anschließend neu.

LLM-API-Schlüssel-Probleme: Überprüfen Sie das Kontingent/den Status im Dashboard des Anbieters. Stellen Sie bei Ollama sicher, dass der Container den Server unter http://host.docker.internal:11434 (Docker Desktop) oder die Host-IP erreichen kann. Prüfen Sie die Logs mit: docker compose logs api | grep -i error.

Besuchen Sie runthisai.com/en/tool/dify für Systemanforderungen, VPS-Empfehlungen und weiterführende Tutorials.

#install_guide