OAuth und n8n im Docker – wo’s immer wieder klemmt
n8n plus Google Sheets klingt erstmal nach: Klick, läuft. Wirklich entspannt ist das mit Docker aber eher selten. Sobald Container ins Spiel kommen, häufen sich OAuth-Aussetzer. Meist liegt es an genau zwei Dingen: Daten werden beim Neustart gekillt oder die Google-Konfiguration passt nicht.
Typisch: Nach dem Update oder weil jemand mal eben „docker restart“ tippt, sind plötzlich alle OAuth-Tokens weg. n8n meckert nicht direkt – die Workflows laufen einfach ins Leere. Fehler tauchen gerne erst Tage später auf, wenn jemand ein Ergebnis braucht. Dann beginnt das große Suchen.
Token futsch? Meistens Volume vergessen
Google OAuth-Tokens haben einen Haken: Sie leben nicht lange und brauchen ein Zuhause. Docker löscht aber alles, was nicht explizit als Volume gemountet wurde. Wer /home/node/.n8n nicht auf dem Host sichert, kann nach jedem Neustart wieder von vorne anfangen. Die Folge: Credentials im Frontend sehen aus wie immer, aber die API-Calls scheitern klammheimlich.
Ein falscher Mountpoint, schon ist Feierabend. Besonders nervig, wenn mehrere Container laufen und keiner weiß mehr, welcher gerade das richtige Volume benutzt. Das Frontend bleibt stumm, bis der Workflow wieder scheitert.
Praxislösung: Immer ein Volume für die n8n-Daten mounten. Im Docker Compose zum Beispiel so:
volumes:
- ./n8n-data:/home/node/.n8n
So gehen Tokens, Workflows und Logs nicht verloren. Klingt banal, spart aber Nerven.
Redirect-URI und Google Console – Fehlerquellen en masse
Die meisten OAuth-Probleme entstehen schon vor dem ersten Workflow. Google verlangt, dass die Redirect-URI exakt stimmt – inklusive Port, Protokoll, manchmal sogar Slash am Ende. Wird n8n lokal getestet, steht da oft noch „localhost“ drin, obwohl später über eine externe Domain gearbeitet wird. Ergebnis: „redirect_uri_mismatch“. Klassiker.
Weitere Stolpersteine:
- Google Sheets API nicht aktiviert.
- Port oder Pfad in der Redirect-URI stimmt nicht mit der echten Adresse überein.
Kurz: Eine falsch gesetzte URI, und der ganze OAuth-Zauber macht Pause. Nach jeder Änderung lohnt ein Testlauf.
Tokens erneuern: Reset hilft oft mehr als Flickschusterei
Wenn nichts mehr geht: Credentials im n8n-Editor löschen. Neue anlegen, OAuth-Flow sauber durchziehen. Wichtig: Die Redirect-URI muss exakt zur echten n8n-Adresse passen. Fehler wie „invalid_grant“ oder „redirect_uri_mismatch“ deuten fast immer auf einen Konfigurationspatzer hin.
Logs helfen. Selbst wenn n8n im Frontend schweigt, zeigt ein Blick in die Container-Logs oder die Google Console oft, wo’s hakt.
30 Jahre Webentwicklung – was aus Erfahrung bleibt
In Projekten fällt immer wieder auf: Technik ist selten das Problem, sondern banale Flüchtigkeitsfehler. Docker verschärft das, weil die Fehler häufig erst spät auffallen oder nach Updates plötzlich auftauchen. Wer auf persistente Volumes vergisst, kann schon mal einen halben Tag mit Fehlersuche vertrödeln.
Typischer Agentur-Fail: Setup gut gemeint, Dokumentation fehlt. Dann startet der Kollege neu, Credentials weg, Projekt steht. Wer sauber dokumentiert und Volumes regelmäßig kontrolliert, ist klar im Vorteil.
Für Einzelkämpfer heißt das: Nach jedem Update prüfen, ob Volumes und Redirects noch stimmen. Einmal vertippt, läuft nichts mehr. Das passiert öfter, als man denkt.
Meine Einschätzung: Wirklich sparen lässt sich nur, wer sich einmal sauber durch die Docker- und Google-Console-Einstellungen kämpft – und alles dokumentiert. Sonst gibt’s Supporttickets ohne Ende.
Praxis-Shortlist: Was erspart Frust im Alltag?
- Backups der n8n-Datenbank automatisieren (z.B. via Cronjob auf dem Host).
- OAuth-Credentials nie nur im Container speichern, immer ins Volume.
- In der Google Console: APIs aktiv? Redirect-URIs korrekt?
- Fehleranalyse nicht nur im n8n-Frontend – Logs anschauen.
- Nach jeder Änderung an OAuth-Settings: Einmal Testdurchlauf machen.
Wer das beachtet, hat deutlich weniger Überraschungen.
Weitere Quellen
Mehr Praxis-Tipps zu n8n und Docker: n8n mit Docker: Installation, Updates und Backups – was in der Praxis wirklich zählt.
Agentur-Sicht auf Aufwand und Nutzen: n8n für Agenturen: Lohnt sich der Aufwand wirklich?.
Fazit: Meistens simpel, aber gerne übersehen
OAuth-Aussetzer bei n8n und Google Sheets im Docker sind fast immer auf vergessene Volumes oder krumme Redirect-URIs zurückzuführen. Wer die Basics im Griff hat und nicht aus Bequemlichkeit auf Dokumentation verzichtet, ist klar im Vorteil. Kleiner Aufwand – großer Effekt. Wer sich die Arbeit nicht macht, sucht später doppelt so lang.
bye
mo