n8n-Umgebungsvariablen: Compose, Prozesswerte und Workflows trennen

Vier Arten von Werten auseinanderhalten

Zusätzlich gibt es normale Datenfelder innerhalb eines einzelnen Workflows. Dass dort etwa ein Feld umgebung heißt, macht daraus weder eine Prozessumgebung noch eine getrennte Produktivinstanz.

Beim npm-Start erbt n8n die Umgebung seines Startprozesses. Bei Docker kommt eine Containergrenze dazu. Die Anzeige eines Werts in einem anderen Terminal beweist deshalb noch nicht, was der laufende Dienst tatsächlich erhalten hat.

Eine harmlose Einstellung mit Compose übergeben

Für den Einstieg änderst du eine vorhandene Lerninstanz mit bekanntem Compose-Projekt. Der grundlegende Aufbau steht im Guide n8n mit Docker Compose einrichten. Das folgende Fragment ist kein vollständiges neues Deployment und ersetzt weder Image noch Volumes deiner bestehenden Datei.

Lege für die reine Platzhalterquelle im passenden Projektkontext einen nicht geheimen Wert fest:

TOKENWERK_TIMEZONE=Europe/Berlin

Verbinde ihn im bestehenden Dienst ausdrücklich mit der n8n-Umgebung. Die Datei allein wäre dafür nicht genug. Eine Kopie des eigenen Compose-Fragments steht auch als Textdownload bereit.

services:
  n8n:
    environment:
      GENERIC_TIMEZONE: "${TOKENWERK_TIMEZONE:?TOKENWERK_TIMEZONE fehlt}"
      N8N_BLOCK_ENV_ACCESS_IN_NODE: "true"

Der Ausdruck ${TOKENWERK_TIMEZONE:?TOKENWERK_TIMEZONE fehlt} verlangt einen gesetzten nichtleeren Wert. GENERIC_TIMEZONE ist die n8n-Instanzzeitzone für zeitgesteuerte Nodes. Eine gegebenenfalls zusätzlich gesetzte Betriebssystemzeitzone hat eine eigene Aufgabe.

Die Zugriffssperre im Beispiel lässt Prozesswerte nicht als allgemeine Quelle für Expressions und Code zu. Falls deine bisherigen Workflows davon abhängen, prüfe die Änderung zuerst isoliert. Geheimnisse werden in diesem Beispiel weder gesetzt noch ausgegeben.

Änderungen anwenden und gezielt prüfen

Prüfe vor einer Änderung deine bestehende Sicherung, den Dienstnamen und die Auswirkung auf laufende Aufträge. Die folgenden Befehle setzen voraus, dass du im richtigen Compose-Projekt bist und der Dienst n8n heißt.

docker compose config --services
docker compose up -d --no-deps n8n
docker compose ps
docker compose exec n8n node -e "console.log(process.env.GENERIC_TIMEZONE)"

up kann den Dienst bei geänderter Konfiguration neu erstellen und behält dabei die eingebundenen Volumes. Ein bloßes docker compose restart übernimmt geänderte Compose-Umgebungswerte nicht. Ein neuer Container und ein Neustart desselben Containers sind unterschiedliche Vorgänge.

Der letzte Befehl liest bewusst nur die nicht geheime Zeitzone aus dem n8n-Container. Erwartet wird der von dir gewählte Wert, hier Europe/Berlin. Ein vollständiger Env-Dump oder eine aufgelöste private Gesamtkonfiguration ist für diesen Check unnötig.

Queue-Worker, mehrere Instanzen und zusätzliche Dienste brauchen einen abgestimmten eigenen Ablauf. Für diesen Artikel wurde kein Dockerdienst verändert; die Befehle sind ein dokumentiertes Beispiel.

Webhook- und Editoradresse korrekt zuordnen

Die aktuelle Referenz verwendet N8N_WEBHOOK_URL für die Basis der Test- und Produktionswebhooks. WEBHOOK_URL ist seit n8n 2.35 ein veralteter Alias und erzeugt nach Herstellerbeschreibung eine Warnung. Verwende den aktuellen Namen passend zu deiner tatsächlichen Version.

N8N_WEBHOOK_URL=https://n8n.example.com/
N8N_EDITOR_BASE_URL=https://n8n.example.com/
N8N_PROXY_HOPS=1

example.com ist ein Platzhalter. Diese Zeilen richten weder DNS noch HTTPS oder einen Reverse Proxy ein. Der Hopwert 1 passt nur zur angenommenen einen vertrauten Proxyebene; er muss der wirklichen Kette entsprechen. Die erforderlichen Forwarded-Header gehören ebenfalls zur Proxykonfiguration.

N8N_ENDPOINT_WEBHOOK verändert dagegen einen Pfad, nicht die vollständige öffentliche Basis-URL. Test- und Produktionswebhooks prüfen zeigt, weshalb sichtbare URL und tatsächlich registrierter Eingang separat getestet werden.

Werte in Workflows passend bereitstellen

Für nicht geheime wiederverwendbare Zeichenketten gibt es Custom Variables, sofern dein Plan sie unterstützt. Die aktuelle Referenz nennt dafür Pro/Enterprise in der Cloud sowie Business/Enterprise beim Selfhosting. Instanzverantwortliche legen sie an; Workflows lesen die Werte.

Schlüssel in Variables: LERNPROFIL
Wert: TEST

Expression im passenden Node:
{{ $vars.LERNPROFIL }}

Die Werte sind Strings und im Workflow read-only. Projektbezogene Variablen können gleichnamige globale Werte innerhalb des Projekts übersteuern. Ein fehlender Wert führt laut Hersteller nicht automatisch zum Fehlschlag; prüfe benötigte Angaben ausdrücklich.

API-Schlüssel und Passwörter gehören nicht als bequem sichtbare Lernprofilwerte in Nodes. n8n-Zugangsdaten im Credential-Dialog verwalten beschreibt den eigenen Weg für Dienstezugänge. Für sensible Instanzkonfigurationen unterstützt n8n bei geeigneten Einstellungen außerdem einen Dateiwert über _FILE; das ist wiederum keine normale Workflowvariable.

Die in älteren Forumbeispielen vorgeschlagene Allowlist für einzelne Env-Namen ist kein durch die hier geprüfte aktuelle Referenz bestätigtes Feature. Gib nicht den gesamten Prozesszugriff frei, nur um einen nicht geheimen Konfigurationswert bequem lesen zu können.

Wenn eine Variable nicht ankommt

Halte Appversion, Startweg und den geprüften nicht geheimen Wert zusammen fest. Aktuelle Expression-Engine-Optionen haben eigene Versionsvoraussetzungen; Backend und Editor sind nicht dieselbe Einstellung. Alte Konfigurationen nicht blind mit einem vollständigen neuen Variablensatz überschreiben.

Dieser Guide basiert auf aktuellen n8n- und Dockeroriginalen. Fragment und Prüfschritte sind eigene Arbeitshilfen. Es wurden weder echte Zugangsdaten verarbeitet noch eine laufende n8n-Instanz umkonfiguriert.