docker-compose.yml<\/strong> einfügen:<\/p>volumes:\n - ~\/redis-conf\/redis.conf:\/usr\/local\/etc\/redis\/redis.conf\ncommand: [\"redis-server\", \"\/usr\/local\/etc\/redis\/redis.conf\"]<\/pre>Nachdem Sie Redis vorbereitet haben, müssen Sie die erforderlichen Variablen konfigurieren, um den Queue-Modus zu aktivieren. In unserem Szenario verfügen wir bereits über eine n8n-Instanz, die mit nginx<\/strong> eingerichtet ist. Als Nächstes verlagern wir diese in eine containerisierte Umgebung.<\/p>Hier sind die wichtigsten Variablen, die Sie festlegen müssen:<\/p>Variable<\/strong><\/th>Zweck<\/strong><\/th><\/tr><\/thead>EXECUTIONS_MODE=queue<\/td> Legt den Queue-Modus als Ausführungsmodus fest<\/td><\/tr> QUEUE_BULL_REDIS_HOST=redis<\/td> Legt den Hostnamen der Redis-Instanz fest. Da wir eine containerisierte Redis-Instanz verwenden, lautet der Wert redis<\/code>.<\/td><\/tr>QUEUE_BULL_REDIS_PORT=6379<\/td> Legt den Port fest, auf dem Redis lauscht (standardmäßig 6379<\/code>)<\/td><\/tr>N8N_RUNNERS_ENABLED=true<\/td> Aktiviert bzw. deaktiviert die Ausführung von Tasks<\/td><\/tr> OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS=true<\/td> Stellt sicher, dass auch manuell ausgeführte Workflows an die Worker weitergeleitet werden<\/td><\/tr><\/tbody><\/table><\/figure>Weitere wichtige Variablen sind:<\/p>Variable<\/strong><\/th>Zweck<\/strong><\/th><\/tr><\/thead>QUEUE_HEALTH_CHECK_ACTIVE=true<\/td> Aktiviert eine interne Zustandsprüfung zur Überwachung der Redis-Verbindung<\/td><\/tr> QUEUE_BULL_REDIS_PASSWORD<\/td> Falls Sie ein Passwort für Redis festgelegt haben, geben Sie es auch hier ein<\/td><\/tr><\/tbody><\/table><\/figure>Da Sie nun wissen, welche Einstellungen erforderlich sind, lassen Sie uns diese einrichten.<\/p>
\nWechseln Sie zurück in Ihr Arbeitsverzeichnis:<\/li>\n<\/ol>cd ~\/n8n-queue-mode<\/pre>\nErstellen Sie eine .env-Datei, in der Ihre Variablen gespeichert werden. Falls Sie möchten, können Sie diese umbenennen:<\/li>\n<\/ol>sudo nano .env<\/pre>Speichern Sie folgende Werte:<\/p>
N8N_LOG_LEVEL=debugN8N_LOG_OUTPUT=console\nN8N_BASIC_AUTH_ACTIVE=trueN8N_BASIC_AUTH_USER=<your_username>N8N_BASIC_AUTH_PASSWORD=<your_password>\nN8N_HOST=srv721674.hstgr.cloudN8N_PORT=5678N8N_PROTOCOL=httpsWEBHOOK_URL=https:\/\/srv721674.hstgr.cloud\/GENERIC_TIMEZONE=UTC\nN8N_EXPRESS_TRUST_PROXY=trueN8N_SECURE_COOKIE=true\nEXECUTIONS_MODE=queueQUEUE_BULL_REDIS_HOST=redisQUEUE_BULL_REDIS_PORT=6379N8N_RUNNERS_ENABLED=trueOFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS=true<\/pre>Die zusätzlichen Werte für den Queue-Modus sind fett hervorgehoben – falls Sie bereits über eine Umgebungsdatei verfügen, können Sie lediglich die fettgedruckten Zeilen zu Ihrer bestehenden Konfiguration hinzufügen.<\/p>
\n\n\n
\n
\n
\n \n <\/svg>\n \n Profi-Tipp <\/p>\n <\/div>\n
Die Protokollierungseinstellungen sind zwar optional, erweisen sich jedoch als nützlich, um den Status unserer Container zu überprüfen und Fehler zu beheben.<\/p>\n <\/div>\n \n\n\n\n<\/p>
\nSpeichern Sie Ihre Änderungen, indem Sie Strg + X → Y → Enter<\/strong> drücken<\/li>\n<\/ol>3. Starten Sie den Hauptprozess von n8n<\/h3> Bisher haben Sie alle Umgebungsvariablen definiert, die für die Funktion des Queue-Modus erforderlich sind. Nun definieren wir unseren n8n-Container für den Hauptprozess:<\/p>
\nÖffnen Sie docker-compose.yml<\/strong>, indem Sie folgenden Befehl ausführen:<\/li>\n<\/ol>sudo nano docker-compose.yml<\/pre>\nFügen Sie unter „services“ den folgenden Code hinzu:<\/li>\n<\/ol> n8n:\n image: n8nio\/n8n\n container_name: n8n\n restart: always\n env_file:\n - .env\n ports:\n - \"5678:5678\"\n volumes:\n - ~\/.n8n:\/home\/node\/.n8n depends_on: - redis<\/pre>\nSpeichern Sie Ihre Änderungen, indem Sie Strg + X → Y → Enter<\/strong> drücken<\/li>\n<\/ol>Ihre „docker-compose.yml“-Datei<\/strong> sollte in etwa so aussehen:<\/p>\n
\n\t\t\t\n\t\t\t\t<\/path>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n<\/div>An dieser Stelle können Sie Ihren n8n-Prozess starten, indem Sie folgenden Befehl ausführen:<\/p>
docker compose up -d<\/pre>Melden Sie sich nun bei Ihrer Instanz an – Sie sollten die gewohnte Ansicht sehen. Führen Sie zur Prüfung einen einfachen Workflow aus, der eine Webanfrage an Google sendet:<\/p>
\n
\n\t\t\t\n\t\t\t\t<\/path>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n<\/div>Dies sollte funktionieren, obwohl Sie den Queue-Modus aktiviert und den Hauptprozess so konfiguriert haben, dass er als Warteschlangen-Orchestrator fungiert.<\/p>
Dies ist ein Ausfallsicherheitsmechanismus in n8n: Wenn keine Worker zur Bearbeitung Ihrer Ausführungen verfügbar sind, übernimmt die Hauptinstanz die Arbeit, anstatt sie an Redis zu verteilen.<\/p>
Trotz all dieser Konfigurationen führen Sie n8n noch nicht im Queue-Modus aus. Lassen Sie uns dies ändern, indem wir einige Worker bereitstellen.<\/p>
4. PostgreSQL-Datenbank bereitstellen<\/h3> Nachdem Sie den Hauptprozess konfiguriert haben, legen Sie nun die PostgreSQL-Datenbank an. Dies ist zwar optional, wird jedoch für Workloads auf Produktionsniveau empfohlen, für deren Bearbeitung SQLite schlichtweg nicht ausgelegt ist. Glücklicherweise lässt sich eine Postgres-Datenbank schnell und einfach einrichten:<\/p>
\nÖffnen Sie docker-compose.yml<\/strong>:<\/li>\n<\/ol>sudo nano docker-compose.yml<\/pre>\nFügen Sie am Ende den folgenden Inhalt hinzu:<\/li>\n<\/ol>postgres:\n image: postgres:15\n container_name: n8n-postgres\n restart: always\n environment:\n POSTGRES_USER: n8n\n POSTGRES_PASSWORD: <Ihr_Passwort>\n POSTGRES_DB: n8ndb\n volumes:\n - pgdata:\/var\/lib\/postgresql\/data\n\nvolumes: pgdata:<\/pre>\nSpeichern Sie die Datei mit Strg + X → Y → Enter<\/strong>.<\/li>\n\n\n\nÖffnen Sie Ihre .env-Datei:<\/li>\n<\/ol>sudo nano .env<\/pre>\nFügen Sie die folgenden Konfigurationsangaben für die Postgres-Datenbank hinzu:<\/li>\n<\/ol>DB_TYPE=postgresdb\nDB_POSTGRESDB_HOST=postgres\nDB_POSTGRESDB_PORT=5432\nDB_POSTGRESDB_DATABASE=n8ndb\nDB_POSTGRESDB_USER=n8n\nDB_POSTGRESDB_PASSWORD=<Ihr_Passwort><\/pre>\nSpeichern Sie mit Strg + X → Y → Enter<\/strong>.<\/li>\n<\/ol>Starten Sie nun das Programm:<\/p>
docker compose up -d<\/pre>Sie können außerdem überprüfen, ob die PostgreSQL-Datenbank funktioniert, indem Sie folgenden Befehl ausführen:<\/p>
docker exec -it n8n-postgres psql -U n8n -d n8ndb\n\\dt<\/pre>Optional können Sie nun SQLite löschen:<\/p>
rm ~\/.n8n\/database.sqlite\nrm ~\/.n8n\/*.sqlite*<\/pre>\n\n\n
\n
\n \n \n <\/svg>\n Important\n <\/span>\n \n Wichtig!<\/strong> Falls der Wert für den Verschlüsselungsschlüssel für Ihre Hauptinstanz nicht festgelegt ist, generiert n8n beim Neuerstellen der Konfigurationsdatei einen neuen Schlüssel. Um dies zu vermeiden, empfehlen wir, N8N_ENCRYPTION_KEY in beiden Umgebungsdateien festzulegen, um die Zuverlässigkeit zu gewährleisten.\n <\/p><\/div>\n\n\n\n<\/p>5. Worker-Prozesse starten<\/strong><\/h3>Sobald sich n8n im Queue-Modus befindet, ist es auf dedizierte Worker-Prozesse angewiesen, um Aufträge aus Redis abzurufen. Richten wir einen Worker-Prozess ein:<\/p>
\nRufen Sie zunächst den Verschlüsselungsschlüssel für die Worker ab. Sie können ihn bei der Erstellung einer neuen n8n-Instanz selbst festlegen – andernfalls generiert n8n automatisch einen für Sie, falls kein Schlüssel angegeben wurde. Führen Sie folgenden Befehl aus:<\/li>\n<\/ol>cat ~\/.n8n\/config<\/pre>Kopieren Sie den Wert von encryptionKey<\/strong>, da Sie ihn in Ihren Umgebungsvariablen speichern müssen.<\/p>\nErstellen Sie eine neue Umgebungsdatei für die Worker. Sie können zwar eine einzige Datei für alle n8n-Instanzen verwenden, doch die Trennung in eine Haupt- und eine Worker-Datei erleichtert die Verwaltung:<\/li>\n<\/ol>sudo nano .env.worker<\/pre>\nFügen Sie die folgenden Konfigurationsangaben ein:<\/li>\n<\/ol>N8N_LOG_LEVEL=debugN8N_LOG_OUTPUT=console\nEXECUTIONS_MODE=queue\nN8N_RUNNERS_ENABLED=true\nOFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS=trueN8N_ENCRYPTION_KEY=<your_encryption_key>\n\nQUEUE_BULL_REDIS_HOST=redis\nQUEUE_BULL_REDIS_PORT=6379\n\nDB_TYPE=postgresdb\nDB_POSTGRESDB_HOST=postgres\nDB_POSTGRESDB_PORT=5432\nDB_POSTGRESDB_DATABASE=n8ndb\nDB_POSTGRESDB_USER=n8n\nDB_POSTGRESDB_PASSWORD=<Ihr_Passwort><\/pre>\nSpeichern Sie die Datei mit Strg + X → Y → Enter<\/strong>.<\/li>\n\n\n\nÖffnen Sie die Datei docker-compose.yml<\/strong>:<\/li>\n<\/ol>sudo nano docker-compose.yml<\/pre>\nFügen Sie diesen Dienst direkt unterhalb des PostgreSQL-Dienstes ein:<\/li>\n<\/ol>n8n-worker:\n image: n8nio\/n8n\n restart: always\n command: worker\n env_file:\n - .env.worker\n depends_on:\n - redis\n - postgres<\/pre>\nSpeichern Sie die Datei mit Strg + X → Y → Enter<\/strong>.<\/li>\n\n\n\nStarten Sie den Worker-Knoten:<\/li>\n<\/ol>docker compose up -d n8n-worker<\/pre>\n\n\n
\n
\n \n \n <\/svg>\n Important\n <\/span>\n \n Wichtig!<\/strong> Wenn Sie für Ihre Hauptinstanz keinen Verschlüsselungsschlüssel festlegen, erstellt n8n bei der nächsten Neuerzeugung der Konfigurationsdatei einen neuen Schlüssel. Um das zu vermeiden, empfehlen wir, N8N_ENCRYPTION_KEY in beiden Umgebungsdateien zu setzen – so bleibt das System zuverlässig.\n <\/p><\/div>\n\n\n\n<\/p>Um weitere Worker zu starten, führen Sie docker compose<\/code> mit dem Argument scale<\/code> aus:<\/p>docker compose up -d --scale n8n-worker=3<\/pre>\n
\n\t\t\t\n\t\t\t\t<\/path>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n<\/div>6. Testen Sie die Konfiguration<\/h3> Um zu testen, ob der N8N-Queue-Modus funktioniert, führen Sie einige Test-Workflows aus oder planen Sie einen Workflow ein. Hier verwenden wir einen einfachen aktiven Workflow, der in Intervallen von zehn Sekunden ausgeführt wird:<\/p>
\n
\n\t\t\t\n\t\t\t\t<\/path>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n<\/div>Kehren Sie nach einigen Minuten zu Ihrem Terminal zurück und überprüfen Sie die Protokolle des n8n-Workers:<\/p>
docker logs <Name des Arbeiters> -f<\/pre>Sie sollten etwa folgende Ausgabe sehen:<\/p>
\n
\n\t\t\t\n\t\t\t\t<\/path>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n<\/div>Achten Sie insbesondere auf Einträge wie Worker started execution <Zahl><\/strong>, die zeigen, dass n8n erfolgreich Aufträge vom Message Broker abruft.<\/p>
![\"Schematische](\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/29\/2026\/08\/n8n-queue-modus.jpeg\/w=1024,h=1024,fit=scale-down\")