N8N Power: Smarte Docker-Automatisierung für dein Homelab

Willkommen in der Welt der Automation: Dein Homelab auf Autopilot

Als erfahrener Admin und passionierter Homelab-Enthusiast weiß ich genau, wie viel Zeit man mit wiederkehrenden Routineaufgaben verbringen kann. Ob es das Prüfen des Status eines Dienstes ist, das Aufräumen von Logs oder das Versenden von Benachrichtigungen bei bestimmten Ereignissen – all das sind Aufgaben, die uns von spannenderen Projekten abhalten. Genau hier kommt die Automatisierung ins Spiel. Ich habe in meiner Laufbahn schon viele Tools getestet, aber für das Homelab und kleine bis mittlere Projekte hat sich eine Kombination als besonders mächtig und flexibel erwiesen: n8n, orchestriert mit Docker auf einem zuverlässigen Proxmox-Host.

Der Gedanke, "Bots" die Arbeit machen zu lassen, klingt vielleicht nach Science-Fiction oder teuren Enterprise-Lösungen wie "Automation Anywhere", die im Heise-Artikel erwähnt werden. Aber ich kann dir versichern: Mit Open-Source-Tools wie n8n kannst du dir deine eigene, mächtige Automatisierungszentrale aufbauen, die genau auf deine Bedürfnisse zugeschnitten ist – und das völlig kostenlos. In diesem Guide zeige ich dir Schritt für Schritt, wie du n8n in deinem Homelab einrichtest und deinen ersten smarten Workflow erstellst, der dir wirklich Arbeit abnimmt. Wir werden uns ansehen, wie du den Status eines Docker-Containers überwachst und dich benachrichtigen lässt, wenn etwas nicht stimmt.

Voraussetzungen: Was du für den Start brauchst

Bevor wir loslegen, lass uns sicherstellen, dass du die nötige Basis geschaffen hast. Keine Sorge, das Meiste davon hast du als Homelab-Betreiber wahrscheinlich schon am Laufen.

Proxmox VE Host: Dein zentraler Server, auf dem wir eine virtuelle Maschine für n8n und Docker bereitstellen werden. Ausreichend Ressourcen sind wichtig. Ich empfehle mindestens 4 GB RAM und 2 vCPUs für die VM, die n8n hostet, damit alles geschmeidig läuft, besonders wenn du später komplexere Workflows planst.
Eine frische Debian/Ubuntu VM: Eine saubere Installation von Debian 12 (oder Ubuntu LTS) ist ideal. Wir werden darauf Docker und n8n installieren. Ein SSH-Zugang zur VM ist unerlässlich, da wir fast alles über die Kommandozeile erledigen werden.
Grundlegende Linux-Kenntnisse: Du solltest dich auf der Shell bewegen können, wissen, wie man Pakete installiert (`apt`), Dienste verwaltet (`systemctl`) und Dateien bearbeitet (`nano` oder `vim`).
Netzwerkgrundlagen: Verständnis für IP-Adressen, Ports und eventuell grundlegende Firewall-Regeln ist hilfreich. Ich empfehle eine statische IP-Adresse für deine n8n-VM.
Docker & Docker Compose: Das sind die Werkzeuge, mit denen wir n8n als Container betreiben und konfigurieren werden. Keine Sorge, die Installation zeige ich dir.
Ein Quäntchen Geduld und Experimentierfreude: Automatisierung ist ein Lernprozess. Manchmal hakt es, aber die Befriedigung, wenn ein Workflow endlich reibungslos läuft, ist unbezahlbar!

Schritt-für-Schritt-Anleitung: Dein Weg zur n8n-Automatisierung

1. Die Basis-VM auf Proxmox vorbereiten

Zuerst erstellen wir eine neue VM auf deinem Proxmox-Host. Ich verwende hier gerne Debian, da es schlank und stabil ist.

VM erstellen: Im Proxmox Webinterface klickst du auf "VM erstellen". Gib ihr einen passenden Namen (z.B. n8n-automation).
- OS: Wähle dein Debian/Ubuntu ISO aus.
- System: Standardeinstellungen sind meist okay.
- Disks: Mindestens 32 GB Festplattenspeicher.
- CPU: Mindestens 2 Cores.
- Memory: Mindestens 4096 MB (4 GB).
- Network: Bridged-Modus, wenn du direkten Netzwerkzugriff möchtest. Vergiss nicht, nach der Installation eine statische IP zu konfigurieren.
System aktualisieren: Nach der Installation und dem ersten Login via SSH solltest du dein System auf den neuesten Stand bringen:

sudo apt update
sudo apt upgrade -y
sudo apt install -y curl git nano # Nützliche Tools

Mein Tipp: Richte dir auch einen SSH-Key ein, um das Login sicherer und bequemer zu machen.

2. Docker und Docker Compose installieren

Jetzt installieren wir Docker und Docker Compose. Das ist der Unterbau, auf dem n8n laufen wird.

Docker Engine installieren:

# Offizielles Docker Installationsskript verwenden
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# Deinen Benutzer zur Docker-Gruppe hinzufügen, damit du Docker-Befehle ohne sudo ausführen kannst
sudo usermod -aG docker $USER

# Änderungen übernehmen (oder einfach neu anmelden)
newgrp docker

# Docker Status prüfen
docker run hello-world

Wenn "Hello from Docker!" erscheint, ist alles in Ordnung. Wichtig zu wissen: Nach `usermod` musst du dich neu anmelden oder `newgrp docker` ausführen, damit die Gruppenänderung aktiv wird.

Docker Compose installieren:

# Aktuelle Version von Docker Compose herunterladen (Link prüfen, kann sich ändern!)
# Die neueste Version findest du hier: https://github.com/docker/compose/releases
# Beispiel für 2.24.5 (Stand Januar 2024)
sudo curl -L "https://github.com/docker/compose/releases/download/v2.24.5/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

# Ausführbar machen
sudo chmod +x /usr/local/bin/docker-compose

# Version prüfen
docker-compose --version

In meiner Erfahrung ist es immer ratsam, die offizielle Docker-Dokumentation für die aktuellste Installationsmethode zu konsultieren, da sich URLs und Versionen ändern können.

3. n8n mit Docker Compose aufsetzen

Jetzt kommt der spannendste Teil: Wir bringen n8n zum Laufen. Wir nutzen Docker Compose, um n8n mit persistenter Datenhaltung und den notwendigen Umgebungsvariablen zu konfigurieren.

Verzeichnis für n8n erstellen:

mkdir ~/n8n
cd ~/n8n

docker-compose.yml erstellen: Lege eine neue Datei namens `docker-compose.yml` an und füge den folgenden Inhalt ein.

version: '3.8'

services:
  n8n:
    image: n8nio/n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      - N8N_HOST=deine.n8n.domain.oder.ip # Ersetze dies! Z.B. n8n.homelab.local oder die IP der VM
      - N8N_PROTOCOL=http # Wenn du keinen Reverse Proxy mit HTTPS hast, bleib bei http
      - WEBHOOK_URL=http://deine.n8n.domain.oder.ip:5678/ # Wichtig für Webhook-Trigger
      - GENERIC_TIMEZONE=Europe/Berlin # Oder deine Zeitzone
      - N8N_BASIC_AUTH_ACTIVE=true # Für grundlegenden Login-Schutz
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=deinSuperSicheresPasswort # Unbedingt ändern!
      # Wenn du später Datenbanken wie PostgreSQL verwenden möchtest, hier konfigurieren
      # - DB_TYPE=postgresdb
      # - DB_POSTGRESDB_HOST=postgres
      # - DB_POSTGRESDB_DATABASE=n8n
      # - DB_POSTGRESDB_USER=n8n
      # - DB_POSTGRESDB_PASSWORD=deinPostgresPasswort
    volumes:
      - n8n_data:/home/node/.n8n
      - /var/run/docker.sock:/var/run/docker.sock # <-- GANZ WICHTIG für Docker-Interaktionen vom Host!
    # Wenn du eine PostgreSQL-Datenbank betreiben willst, würde sie hier als weiterer Service hinzukommen
    # depends_on:
    #   - postgres

# Volumes für persistente Daten
volumes:
  n8n_data:
    driver: local
  # postgres:
  #   driver: local # Für PostgreSQL Daten, falls genutzt

Wichtig zu wissen:

Ersetze deine.n8n.domain.oder.ip durch die tatsächliche IP-Adresse deiner VM (z.B. 192.168.1.100) oder einen DNS-Namen, wenn du einen hast.
Ändere deinSuperSicheresPasswort. Das ist dein erster Schutz für die n8n-Oberfläche.
Der Eintrag - /var/run/docker.sock:/var/run/docker.sock ist absolut entscheidend! Ohne ihn kann n8n, das ja im Container läuft, nicht mit dem Docker-Daemon auf deinem Host kommunizieren. Dies erlaubt n8n, Docker-Befehle (wie Container-Status abfragen) auf deinem Host auszuführen.

n8n starten: Speichere die Datei und starte n8n mit Docker Compose:

docker-compose up -d

Der Parameter `-d` sorgt dafür, dass die Container im Hintergrund laufen. Nach einigen Momenten kannst du n8n im Browser unter http://deine.n8n.domain.oder.ip:5678 erreichen. Melde dich mit den in der docker-compose.yml definierten Zugangsdaten an.

Mein Tipp: Wenn du später HTTPS nutzen möchtest, empfehle ich einen Reverse Proxy wie Nginx Proxy Manager oder Traefik, ebenfalls als Docker-Container. Das ist aber ein Thema für einen anderen Guide.

4. Dein erster smarter Workflow: Docker Container überwachen und benachrichtigen

Jetzt erstellen wir unseren ersten Workflow. Ziel ist es, den Status eines Docker-Containers zu überwachen (z.B. Home Assistant) und eine Benachrichtigung zu senden, wenn er nicht läuft.

Neuen Workflow erstellen: Im n8n Web-UI klicke auf "New Workflow".
Trigger-Node hinzufügen (Cron):
- Suche nach "Cron" und füge die Node hinzu.
- Konfiguriere sie so, dass sie beispielsweise alle 5 Minuten läuft (`*/5 * * * *`). Dies ist unser Zeitplaner.
Execute Command Node hinzufügen:
- Füge eine "Execute Command" Node hinzu. Diese Node wird den Docker-Befehl auf deinem Host ausführen.
- Im Feld "Command" gibst du ein: docker inspect -f '{{.State.Running}}' homeassistant.
- Ersetze homeassistant durch den Namen deines zu überwachenden Containers.
- Wichtig: Stelle sicher, dass "Execute Command" unter dem Benutzer läuft, der Zugriff auf den Docker-Socket hat (normalerweise der, der den Docker-Container gestartet hat und in der Docker-Gruppe ist).
IF-Node hinzufügen:
- Verbinde den Output der "Execute Command" Node mit einer "IF" Node.
- Die "IF" Node prüft, ob der Container läuft.
- Konfiguriere die Bedingung:
  - Value 1: Wähle den Output der vorherigen Node. Das ist meist {{ $('Execute Command').item.json.stdout }}.
  - Operation: "is equal to"
  - Value 2: false (Als String, da der Output von Docker ein String ist: "true\n" oder "false\n". Du musst eventuell noch Leerzeichen/Zeilenumbrüche trimmen, oder eine "Code" Node davor schalten, die den Output bereinigt. Für den Anfang funktioniert "false\n" oft gut.)
Benachrichtigungs-Node hinzufügen (z.B. Telegram):
- Verbinde den "false"-Output der "IF"-Node mit einer Benachrichtigungs-Node deiner Wahl. Ich nutze hier oft Telegram, da es einfach einzurichten ist.
- Suche nach "Telegram" und füge die Node hinzu.
- Du musst zuerst eine "Credential" für Telegram einrichten (deinen Bot-Token und Chat-ID). Eine kurze Suche nach "Telegram Bot erstellen" zeigt dir, wie das geht.
- Im Feld "Text" gibst du eine Nachricht ein, z.B.: 🚨 Achtung: Docker-Container 'homeassistant' ist NICHT am Laufen!

Dein Workflow sollte nun in etwa so aussehen: Cron -> Execute Command -> IF -> Telegram

Jetzt kannst du den Workflow einmal manuell testen, indem du auf "Execute Workflow" klickst. Beobachte die Ausführung und die Ergebnisse in den einzelnen Nodes. Wenn du den zu überwachenden Container stoppst (z.B. `docker stop homeassistant`), sollte nach kurzer Zeit eine Benachrichtigung eintreffen.

5. Workflow aktivieren und testen

Wenn dein Workflow manuell funktioniert, ist es Zeit, ihn zu aktivieren. Klicke oben rechts auf den Schalter "Active", um den Workflow zu planen.

Testen:

Stoppe deinen Ziel-Container manuell:
```
docker stop homeassistant
```
Warte die eingestellte Cron-Zeit ab (z.B. 5 Minuten).
Du solltest eine Benachrichtigung erhalten.
Starte den Container wieder:
```
docker start homeassistant
```
Der Workflow sollte nun keine Benachrichtigung mehr senden.

Herzlichen Glückwunsch! Du hast deinen ersten smarten Workflow in n8n erstellt.

Häufige Fehler und Lösungen

Wer das zum ersten Mal einrichtet, stolpert oft über ähnliche Hürden. Hier sind die häufigsten Probleme, die mir begegnet sind, und wie ich sie löse:

1. n8n Web-UI nicht erreichbar

Problem: Du kannst n8n im Browser unter der konfigurierten IP und Port 5678 nicht erreichen.
Lösung:
- Port-Mapping prüfen: Ist in deiner docker-compose.yml der Port 5678:5678 korrekt eingetragen?
- Container-Status prüfen: Läuft der n8n-Container überhaupt?
```
docker ps -a | grep n8n
```
  Sollte "Up X minutes" anzeigen. Wenn nicht, schau in die Logs:
```
docker logs n8n
```
- Firewall: Hast du eine Firewall auf deiner VM aktiv (z.B. UFW)? Erlaube den Port 5678:
```
sudo ufw allow 5678/tcp
sudo ufw enable # Falls noch nicht aktiv
sudo ufw status
```
- N8N_HOST/WEBHOOK_URL: Stelle sicher, dass diese Umgebungsvariablen in der docker-compose.yml korrekt auf die IP oder den Hostnamen deiner VM zeigen.

2. Execute Command Node funktioniert nicht oder gibt Fehler aus

Problem: Der "Execute Command" Node in n8n liefert einen Fehler wie "permission denied" oder "command not found", oder der Docker-Befehl funktioniert nicht wie erwartet.
Lösung:
- Docker Socket Mount: Das ist der häufigste Fehler! Hast du - /var/run/docker.sock:/var/run/docker.sock in deiner docker-compose.yml unter den Volumes für den n8n-Service eingetragen? Ohne das hat n8n keinen Zugriff auf den Docker-Daemon des Hosts. Nach dem Hinzufügen musst du den Container neu starten:
```
cd ~/n8n
docker-compose down
docker-compose up -d
```
- Berechtigungen auf dem Host: Obwohl der Socket-Mount die Kommunikation ermöglicht, können manchmal Berechtigungsprobleme auftreten, wenn der n8n-Container-User nicht die nötigen Rechte hat. Ein schneller (aber weniger sicherer) Workaround für Homelab-Umgebungen ist, die Rechte des Sockets zu lockern:
```
sudo chmod 666 /var/run/docker.sock
```
  Dies sollte jedoch nur in einer kontrollierten Homelab-Umgebung geschehen. Die bessere Methode wäre, den n8n-User im Container der Docker-Gruppe des Hosts zuzuordnen, was aber komplexer ist.
- Korrekter Befehl: Teste den Befehl, den du in der "Execute Command" Node verwendest, direkt auf deiner VM-Shell, um sicherzustellen, dass er dort funktioniert und die erwartete Ausgabe liefert.

3. Benachrichtigungen kommen nicht an

Problem: Der Workflow läuft durch, aber die Telegram-Nachricht (oder E-Mail, etc.) kommt nicht an.
Lösung:
- Node-Konfiguration: Hast du alle Felder in der Benachrichtigungs-Node korrekt ausgefüllt? Insbesondere API-Keys/Tokens und Chat-IDs für Telegram, oder Server-Details und Logins für E-Mail.
- Credentials: Sind die Credentials in n8n korrekt gespeichert und funktionieren sie? n8n testet die Credentials oft beim Speichern.
- Netzwerkzugriff: Kann deine n8n-VM das Internet erreichen? Manchmal blockiert eine Firewall auf dem Proxmox-Host oder im Router den ausgehenden Traffic. Prüfe, ob du von der n8n-VM aus z.B. Google pingen kannst (`ping google.com`).
- Dienst-Status: Ist der Zieldienst (z.B. Telegram-Server, dein Mailserver) erreichbar und funktioniert er?
- Workflow-Logik: Erreicht der Workflow die Benachrichtigungs-Node überhaupt? Prüfe die Ausführungshistorie des Workflows in n8n. Die "IF"-Node muss wirklich den "false"-Zweig ausgeben, damit die Benachrichtigungs-Node getriggert wird.

Fazit: Dein Homelab wird smarter

Du hast es geschafft! Mit n8n, Docker und Proxmox hast du eine leistungsstarke Automatisierungsplattform in deinem Homelab etabliert. Der hier gezeigte Workflow zur Überwachung eines Docker-Containers ist nur der Anfang. Er zeigt das Potenzial von n8n, manuelle Prüfungen durch automatisierte "Bots" zu ersetzen und dir wertvolle Zeit zu sparen.

In meiner Erfahrung ist n8n ein absoluter Game Changer für Homelab-Enthusiasten. Die Möglichkeiten sind schier grenzenlos:

Integration mit Home Assistant: Trigger Flows basierend auf Sensorwerten, schalte Geräte, sende komplexe Benachrichtigungen.
Dateiverwaltung: Automatisiere das Verschieben, Umbenennen oder Löschen von Dateien nach bestimmten Regeln.
API-Interaktionen: Verbinde verschiedene Dienste und APIs miteinander, die sonst nicht direkt kommunizieren würden.
Web Scraping: Sammle Informationen von Webseiten und verarbeite sie weiter.

Mein Tipp zum Abschluss: Beginne klein, experimentiere viel und scheue dich nicht, die umfangreiche n8n-Dokumentation und Community zu nutzen. Das Schöne an n8n ist die visuelle Oberfläche, die es auch Einsteigern leicht macht, komplexe Workflows zu verstehen und zu bauen. Lass deiner Kreativität freien Lauf und verwandle dein Homelab in eine wirklich intelligente Umgebung!