Lektion 4.3 – Fehlerbild: Mismatching encryption keys
Ziel der Lektion
Sie beheben den Startfehler, wenn der gespeicherte Encryption Key in der n8n-Config nicht zum gesetzten ``N8N_ENCRYPTION_KEY`` passt.
Symptom
In den Logs erscheint z. B.:
- ``Error: Mismatching encryption keys. The encryption key in the settings file /home/node/.n8n/config does not match the N8N_ENCRYPTION_KEY env var.``
Prüfen mit:
docker compose logs -f n8n
Ursache
n8n speichert beim ersten Start einen Key in:
- ``/home/node/.n8n/config``
Bei Persistenz liegt diese Datei auf dem Host hier:
- ``/srv/docker/n8n/data/config``
Wenn Sie später in der ``.env`` einen anderen ``N8N_ENCRYPTION_KEY`` setzen, passt es nicht mehr → n8n startet nicht.
Schritt 1: n8n stoppen
cd /srv/docker/n8n docker compose down
Schritt 2: gespeicherten Key prüfen
sudo cat /srv/docker/n8n/data/config
Sie sehen dort z. B.:
{
"encryptionKey": "..."
}
Lösung A (empfohlen, wenn Sie bestehende Daten behalten wollen)
Setzen Sie in ``/srv/docker/n8n/.env`` den gleichen Key wie in ``/srv/docker/n8n/data/config``.
sudo nano /srv/docker/n8n/.env
Dann:
- ``N8N_ENCRYPTION_KEY=…`` exakt anpassen (1:1)
Start:
cd /srv/docker/n8n docker compose up -d docker compose logs -f n8n
Lösung B (nur wenn Sie bewusst neu starten wollen)
Achtung: Das löscht n8n-Setup (z. B. Benutzer, Einstellungen, Credentials).
cd /srv/docker/n8n docker compose down sudo rm -rf /srv/docker/n8n/data/* docker compose up -d docker compose logs -f n8n
Danach wird die Config neu erzeugt und Ihr ``N8N_ENCRYPTION_KEY`` aus der ``.env`` übernommen.
Merkpunkte
Regel: ``N8N_ENCRYPTION_KEY`` einmal setzen und sicher speichern. Ein ungeplanter Wechsel führt zu Key-Mismatch und Startproblemen.