Diese Anleitung beschreibt, wie n8n lokal über Docker Compose gestartet wird. Das Setup eignet sich für lokale Tests und Entwicklungszwecke.
Voraussetzungen
Damit das Setup funktioniert, sollten folgende Komponenten installiert sein:
- Docker
- Docker Compose
Projektordner anlegen
Erstelle zunächst einen neuen Ordner für dein lokales n8n-Setup, zum Beispiel:
mkdir n8n_tests
cd n8n_tests
Docker Compose Datei erstellen
Lege in diesem Ordner eine Datei mit dem Namen docker-compose.yml an.
Füge folgenden Inhalt in die Datei ein:
volumes:
n8n_storage:
services:
n8n:
image: docker.n8n.io/n8nio/n8n
restart: always
extra_hosts:
- "host.docker.internal:host-gateway"
environment:
- GENERIC_TIMEZONE=Europe/Berlin
- TZ=Europe/Berlin
- N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true
- N8N_RUNNERS_ENABLED=true
- OLLAMA_BASE_URL=http://host.docker.internal:11434
ports:
- 5678:5678
volumes:
- n8n_storage:/home/node/.n8n
n8n starten
Starte n8n mit folgendem Befehl:
docker compose up -d
Nach dem Start ist n8n im Browser erreichbar unter:
http://localhost:5678
Beim ersten Aufruf kannst du deinen lokalen n8n-Account einrichten.
Logs anzeigen
Um die laufenden Logs von n8n anzuzeigen, nutze:
docker compose logs -f
Das ist hilfreich, wenn du prüfen möchtest, ob n8n korrekt gestartet ist oder ob Fehler auftreten.
Status der Container prüfen
Mit folgendem Befehl siehst du, ob der Container läuft:
docker compose ps
n8n stoppen
Um den Container zu stoppen und zu entfernen, aber die gespeicherten n8n-Daten im Docker Volume zu behalten, nutze:
docker compose down
Die Workflows, Zugangsdaten und Einstellungen bleiben dabei erhalten.
n8n aktualisieren
Um das neueste n8n-Image herunterzuladen und den Container neu zu starten, führe folgende Befehle aus:
docker compose pull
docker compose up -d
Alles entfernen inklusive Daten
Wenn du n8n vollständig entfernen möchtest, inklusive aller gespeicherten Daten im Volume, nutze:
docker compose down -v
Achtung: Dadurch werden auch deine lokalen n8n-Daten gelöscht.
Hinweis zur Ollama-Anbindung
In der Konfiguration ist bereits eine Umgebungsvariable für Ollama enthalten:
OLLAMA_BASE_URL=http://host.docker.internal:11434
Damit kann n8n auf eine lokal laufende Ollama-Instanz auf dem Host-System zugreifen. Voraussetzung ist, dass Ollama lokal installiert ist und auf Port 11434 läuft.
