SSD Nodes Learn Hosting plans →
Anleitungen Matt ConnorVon Matt Connor

Gmail mit selbst gehostetem n8n verbinden

Verbinden Sie Gmail mit n8n hinter einem Reverse Proxy, korrigieren Sie die OAuth-Callback-URL und vermeiden Sie mit der richtigen Zielgruppe Googles Token-Ablauf nach sieben Tagen.

So verbinden Sie Gmail mit selbst gehostetem n8n

Um Gmail mit selbst gehostetem n8n zu verbinden, erstellen Sie einen Google-OAuth-Client (Open Authorization) vom Typ Web application. Fügen Sie anschließend die Callback-URL von n8n dort ein. Wenn Ihr Server hinter einem Reverse Proxy betrieben wird, setzen Sie N8N_EDITOR_BASE_URL auf Ihre öffentliche https://-Adresse oder konfigurieren Sie die Webhook-Basis-URL korrekt, damit n8n sie für den Callback verwenden kann. Die Begrenzung auf sieben Tage hängt von der Zielgruppe und dem Veröffentlichungsstatus der Anwendung ab. Eine externe Google-Anwendung, die im Status Testing bleibt, verliert eine Woche nach der Anmeldung ihren Gmail-Zugriff.

Diese Anleitung setzt dort an, wo n8n mit Docker und HTTPS auf einem VPS selbst hosten endet. Ihr Editor ist unter einer https://-Adresse erreichbar, und vor dem Container befindet sich ein Reverse Proxy. Alle Angaben wurden mit n8n 2.41.6 geprüft, der stabilen Version vom 2. Oktober 2026. Die Angaben zu Google wurden am 19. November 2026 anhand der Dokumentation von Google geprüft.

Warum die Callback-URL das Self-Hosting-Problem verursacht

OAuth funktioniert über eine Weiterleitung. n8n leitet Ihren Browser zu Google weiter, und Sie genehmigen den Zugriff. Google leitet Ihren Browser anschließend mit einem einmaligen Code an eine Callback-URL auf Ihrem n8n-Server zurück. Google leitet nur an eine Adresse weiter, die beim OAuth-Client registriert ist. Die Übereinstimmung muss exakt sein: Schema, Host, Port und Pfad müssen übereinstimmen.

Die Google-Credential-Dokumentation von n8n zeigt eine Beispiel-Callback-URL: http://localhost:5678/rest/oauth2-credential/callback. Reverse Proxies werden dort nicht erwähnt. Ein selbst gehostetes n8n zeigt dieselbe Adresse an, wenn nichts anderes konfiguriert ist. Eine neue Installation übermittelt diese Adresse daher an Google.

In n8n 2.41.6 stammt die Callback-URL aus packages/cli/src/services/url.service.ts. Die Basis-URL der Instanz wird in dieser Reihenfolge festgelegt:

  1. N8N_EDITOR_BASE_URL, sofern die Variable gesetzt ist.
  2. Andernfalls die Basis-URL für Webhooks: zuerst N8N_WEBHOOK_URL, danach die ältere Variable WEBHOOK_URL.
  3. Andernfalls eine URL, die aus N8N_PROTOCOL, N8N_HOST, N8N_PORT und N8N_PATH gebildet wird.

n8n hängt anschließend /rest/oauth2-credential/callback an. Dieselbe Funktion versorgt zwei Stellen: die Weiterleitungs-URL im Credential-Dialog und redirect_uri, das n8n an Google sendet. Was Sie im Dialog sehen, erhält auch Google.

Regel 3 ist die Falle. Der Port wird nur entfernt, wenn er der Standardport für das Protokoll ist: 80 für http oder 443 für https. Hinter einem Proxy lauscht n8n weiterhin auf 5678. Daher ergeben N8N_PROTOCOL=https und N8N_HOST=n8n.example.com zusammen https://n8n.example.com:5678/rest/oauth2-credential/callback. Ihr Proxy antwortet nicht auf diesem Port, und Google hat diese URL nicht hinterlegt.

Beide Variablen korrigieren den Dialog. Viele Compose-Dateien setzen nur WEBHOOK_URL. In diesem Fall ist die Callback-URL bereits korrekt, weil die Basis-URL der Instanz darauf zurückfällt. Setzen Sie trotzdem N8N_EDITOR_BASE_URL. Diese Variable hat Vorrang und legt eindeutig fest, welche Adresse gemeint ist. Wenn beide Variablen gesetzt sind und unterschiedliche Werte enthalten, verwendet n8n die Editor-URL für die Callback-URL. Beachten Sie außerdem, dass der Quellcode von 2.41.6 WEBHOOK_URL als veraltet kennzeichnet und durch N8N_WEBHOOK_URL ersetzt.

Legen Sie die öffentliche URL in Ihrer Compose-Datei fest

Fügen Sie die öffentliche Adresse zum environment-Block des n8n-Dienstes hinzu und verwenden Sie Ihre eigene Domain. Wenn n8n unter einem Unterpfad wie https://example.com/n8n/ läuft, muss der Pfad enthalten sein.

services:
  n8n:
    environment:
      - N8N_HOST=n8n.example.com
      - N8N_PROTOCOL=https
      - N8N_EDITOR_BASE_URL=https://n8n.example.com/
      - WEBHOOK_URL=https://n8n.example.com/

Übernehmen Sie die Änderung mit up -d und nicht mit restart. docker compose restart startet den vorhandenen Container mit seiner alten Umgebung neu, sodass die Änderung unbemerkt ignoriert wird. docker compose up -d erkennt die geänderte Konfiguration und erstellt den Container neu.

docker compose up -d
docker compose exec n8n printenv N8N_EDITOR_BASE_URL

Der zweite Befehl sollte Ihre https://-Adresse ausgeben. Wenn Ihr Dienst nicht n8n heißt, verwenden Sie den Namen aus Ihrer Compose-Datei. Ein abschließender Schrägstrich ist zulässig, da n8n ihn entfernt, bevor es den Callback-Pfad ergänzt.

Öffnen Sie nun n8n und erstellen Sie ein neues Zugangsdatenobjekt vom Typ Gmail OAuth2 API. Lesen Sie das Feld OAuth Redirect URL. Es sollte https://n8n.example.com/rest/oauth2-credential/callback anzeigen, wobei Ihre Domain anstelle des Beispiels eingesetzt ist. Wenn weiterhin localhost oder :5678 angezeigt wird, hat der Container die Variable nicht übernommen. Beheben Sie das, bevor Sie Google konfigurieren, da jeder spätere Schritt diesen Wert übernimmt.

Schritt 1: Google-Cloud-Projekt erstellen

Melden Sie sich mit dem Konto, dem die Anwendung gehören soll, in der Google-Cloud-Konsole an. Erstellen Sie ein neues Projekt mit einem Namen, den Sie später wiedererkennen, zum Beispiel n8n-gmail. Prüfen Sie vor dem Fortfahren, ob der Projektauswahlschalter oben in der Konsole das neue Projekt anzeigt. Alle folgenden Einstellungen gehören zum ausgewählten Projekt. Es ist leicht, das falsche Projekt zu konfigurieren.

Google benennt die Seiten seiner Konsole häufig um. Die folgenden Schritte beschreiben daher das auszufüllende Feld und nicht die genaue Beschriftung der Schaltfläche.

Schritt 2: Gmail API aktivieren

Öffnen Sie die API-Bibliothek für das Projekt, suchen Sie nach Gmail API und aktivieren Sie die API. Wenn Sie diesen Schritt überspringen, ist die Anmeldung trotzdem erfolgreich. Der erste Gmail-Aufruf schlägt dann mit einer Fehlermeldung fehl, die mit Gmail API has not been used in project beginnt und Sie auffordert, die API zu aktivieren.

Schritt 3: Einwilligung, Branding und Zielgruppe einrichten

Früher befand sich dies auf einer Seite namens OAuth-Einwilligungsbildschirm. Seit November 2026 teilt Google dies in Abschnitte auf. Branding und Zielgruppe sind separate Seiten. Dies sind die erforderlichen Felder:

  • App name und user support email. Diese Angaben identifizieren die App und ihre Supportkontaktadresse auf dem Einwilligungsbildschirm von Google.
  • Audience oder Nutzertyp: Internal, External oder Personal. Internal wird nur angezeigt, wenn das Projekt zu einer Google-Cloud-Organisation gehört. Die Anmeldung ist dann auf Mitglieder dieser Organisation beschränkt. Ein persönliches @gmail.com-Konto kann Personal nur für den Ersteller oder External für eine Anwendung mit mehreren Nutzern verwenden.
  • Developer contact email. Google sendet Benachrichtigungen zum Projekt an diese Adresse.
  • Authorized domains im Abschnitt für das Branding. Fügen Sie die Domain hinzu, unter der n8n läuft, zum Beispiel example.com.
  • Test users im Zielgruppenabschnitt für eine External-App im Status Testing. Fügen Sie die Gmail-Adresse hinzu, die Sie verbinden werden. Eine External-App im Status Testing weist alle Personen ab, die nicht in dieser Liste stehen. Ihre Anmeldung endet mit einem access_denied-Fehler.

Für eine neue App, die nur Sie verwenden, konfiguriert der Onboarding-Prozess im Personal-Modus das Projekt und erstellt den OAuth-Client in einem Schritt. Der Personal-Modus ist auf das Google-Konto des Erstellers beschränkt. Für ihn gelten weder ein Ablauf von Testtokens nach sieben Tagen noch ein Limit für OAuth-Nutzer. Außerdem wird kein Bildschirm für nicht verifizierte Apps angezeigt. Diese Auswahl kann nur einmal getroffen werden: Vorhandene External- oder Internal-Apps können nicht auf Personal umgestellt werden. Personal-Apps können nicht auf External oder Internal umgestellt werden.

Lassen Sie bei einer External-App den Veröffentlichungsstatus vorerst auf Testing. Im folgenden Abschnitt zu den sieben Tagen wird erklärt, wann Sie ihn ändern müssen. Für Personal- und Internal-Apps gibt es keinen Veröffentlichungsstatus.

Schritt 4: Einen OAuth-Client für eine Webanwendung erstellen

Erstellen Sie im Bereich für Anmeldedaten oder Clients eine OAuth-Client-ID mit den folgenden Feldern. Wenn das Onboarding im Personal-Modus bereits einen Client für Ihre Webanwendung erstellt hat, bearbeiten Sie stattdessen diesen Client.

  • Anwendungstyp: Webanwendung. Ein Desktop-Client verfügt über kein Feld für eine Redirect-URI und kann daher den Callback von n8n nicht verwenden.
  • Name: beliebiger Name, zum Beispiel n8n.
  • Autorisierte Redirect-URIs: Fügen Sie die OAuth Redirect URL aus dem n8n-Dialog exakt wie angezeigt ein.
  • Autorisierte JavaScript-Ursprünge: Lassen Sie dieses Feld leer. Es handelt sich um eine andere Liste. Eine dort eingefügte Callback-URL hat keine Wirkung.

Speichern Sie den Client. Google zeigt eine Client-ID und ein Client-Secret an. Kopieren Sie das Secret, sobald Google es zum ersten Mal anzeigt. Danach ist es nicht mehr sichtbar. Fügen Sie beide Werte in die n8n-Anmeldedaten ein und wählen Sie anschließend Sign in with Google. Google zeigt den Zustimmungsbildschirm für Ihre Anwendung an. Bestätigen Sie den Zugriff auf Gmail. Im n8n-Dialog sollte das Konto jetzt als verbunden angezeigt werden. Speichern Sie die Anmeldedaten.

So sieht redirect_uri_mismatch aus

Wenn sich die URL im n8n-Dialog und die URL im Google-Client auch nur um ein Zeichen unterscheiden, bricht Google die Anmeldung ab. Die Seite trägt die Überschrift Access blocked: This app's request is invalid und enthält folgenden Text:

Error 400: redirect_uri_mismatch

You can't sign in to this app because it doesn't comply with Google's OAuth 2.0 policy.

If you're the app developer, register the redirect URI in the Google Cloud Console.

Öffnen Sie auf dieser Seite die Anfragedetails. Dort wird der Wert redirect_uri= angezeigt, den n8n tatsächlich gesendet hat. Vergleichen Sie ihn mit der Liste in Ihrem OAuth-Client. Häufige Unterschiede sind: http, obwohl Sie https registriert haben, ein zusätzliches :5678, localhost statt Ihrer Domain und ein fehlender Unterpfad. Wenn der gesendete Wert falsch ist, korrigieren Sie die n8n-Umgebung. Wenn der registrierte Wert falsch ist, korrigieren Sie den Google-Client und warten Sie fünf Minuten bis mehrere Stunden, bis die Änderung übernommen wird. Google weist darauf hin, dass die Übernahme von Änderungen an einem Client einige Zeit dauern kann.

Google kann die Weiterleitung akzeptieren, während Ihr Browser trotzdem auf einer 502- oder 404-Seite landet. In diesem Fall erreicht die Callback-Anfrage n8n nicht. Das ist ein Proxy-Problem. Wie eine nginx-Reverse-Proxy-Konfiguration Anfragen an eine Anwendung weiterleitet erklärt jede Direktive, die dafür verantwortlich sein kann.

Schritt 5: Einen Gmail-Trigger einrichten, der ausgelöst wird

Erstellen Sie einen Workflow und fügen Sie den Knoten Gmail Trigger mit Ihren neuen Zugangsdaten hinzu. Konfigurieren Sie ihn wie folgt:

  • Event: Message Received. Dies ist das einzige Ereignis.
  • Poll Times: während des Tests jede Minute.
  • Read Status-Filter: Belassen Sie ihn bei ungelesenen E-Mails.
  • Search-Filter: optional. Er akzeptiert die Gmail-Suchsyntax, zum Beispiel from:billing@example.com.

Der Gmail Trigger führt Polling durch. Er fragt Gmail nach neuen Nachrichten gemäß dem von Ihnen festgelegten Zeitplan ab. Google muss daher keinen Webhook auf Ihrem Server erreichen. Es wird lediglich ein gültiges Token benötigt.

Senden Sie sich selbst eine Test-E-Mail und rufen Sie anschließend im Knoten ein Testereignis ab. Die Ausgabe sollte die Message-ID und ihre Header anzeigen. Aktivieren Sie den Workflow, damit das Polling auch bei geschlossenem Editor ausgeführt wird. Je nach Version heißt die Steuerung Active oder Publish. Senden Sie eine weitere E-Mail und warten Sie einen Polling-Zyklus ab. In der Ausführungsliste sollte ein erfolgreicher Lauf erscheinen.

Wenn der Workflow später nicht mehr funktioniert, prüfen Sie zwei Punkte: Ist das Token noch gültig? Läuft der Container noch? Im nächsten Abschnitt wird das Token behandelt. Ein gestoppter Container kann eigene Ursachen haben. Warum ein selbst gehostetes n8n immer wieder offline geht behandelt diese Ursachen.

Der Sieben-Tage-Ablauf: Warum Gmail-Workflows nach einer Woche ausfallen

In der n8n-Dokumentation zu Google steht es eindeutig: Für Google-Cloud-Apps mit dem Veröffentlichungsstatus Testing und dem Nutzertyp External laufen „Einwilligung und Tokens nach sieben Tagen ab“. In Googles Dokumentation zu Zielgruppen steht dasselbe: „Autorisierungen durch einen Testnutzer laufen sieben Tage nach der Einwilligung ab.“

So kommt es dazu. Bei der Anmeldung gibt Google n8n ein kurzlebiges Access-Token und ein Refresh-Token. n8n verwendet das Refresh-Token, um jedes Mal ein neues Access-Token abzurufen, wenn das alte abläuft. Bei einer External-App im Status Testing läuft das Refresh-Token selbst sieben Tage nach der Einwilligung ab. Am siebten Tag schlägt die Anfrage zum Erneuern fehl, und Google antwortet mit invalid_grant. Danach schlägt auch jede weitere Gmail-Abfrage fehl.

Zwei Details überraschen viele Nutzer. Die Frist beginnt, sobald Sie Sign in with Google ausgewählt haben, nicht beim letzten Lauf des Workflows. Eine erneute Anmeldung gibt Ihnen lediglich weitere sieben Tage. Wenn eine fehlgeschlagene Ausführung etwa eine Woche nach der Einrichtung invalid_grant anzeigt, prüfen Sie die Zielgruppe und den Veröffentlichungsstatus der App, bevor Sie die Sieben-Tage-Frist verantwortlich machen. Widerrufener Zugriff, Token-Limits und eine Passwortänderung bei einem Konto mit Gmail-Scopes verhindern ebenfalls, dass Refresh-Tokens funktionieren.

Apps im Modus Personal unterliegen dieser Sieben-Tage-Frist nicht. Bei einer vorhandenen External-App wählen Sie abhängig vom verfügbaren Konto einen der folgenden Wege.

Ausweg A: Die External-App für die Produktion veröffentlichen

Ändern Sie auf der Zielgruppenseite den Veröffentlichungsstatus von Testing in In production. Refresh-Tokens, die nach dieser Änderung ausgegeben werden, unterliegen nicht der Sieben-Tage-Frist. Wählen Sie anschließend in n8n noch einmal Sign in with Google. Das bereits vorhandene Token wurde nach den Regeln für Testing ausgegeben. Sie benötigen daher ein neues Token.

Die Veröffentlichung ist nicht dasselbe wie eine Verifizierung. Die von n8n standardmäßig angeforderten Scopes umfassen https://mail.google.com/ und https://www.googleapis.com/auth/gmail.modify. Google stuft beide als eingeschränkt ein. Eine öffentliche App mit eingeschränkten Scopes benötigt eine Verifizierung und, wenn sie eingeschränkte Daten über einen Server speichert oder überträgt, zusätzlich eine Sicherheitsprüfung. Google führt außerdem Ausnahmen auf, die wir am 19. November 2026 geprüft haben. Die passende Ausnahme für eine selbst gehostete External-App in n8n ist Limited Audience. Wenn die App für weniger als 100 Nutzer vorgesehen ist, können Sie und Ihre Nutzer sie ohne Verifizierung weiterverwenden. Personal ist eine separate Ausnahme, die auf das Google-Konto des Erstellers beschränkt ist.

Bei einer nicht verifizierten External-App wird stattdessen der Hinweis für nicht verifizierte Apps angezeigt. Bei der Anmeldung zeigt Google Google hasn't verified this app an. Öffnen Sie auf dieser Seite die erweiterte Option und fahren Sie mit Ihrer App fort. Das ist bei einer External-App normal, die nur Sie verwenden, und wird nur angezeigt, wenn jemand die Einwilligung erteilt. Google begrenzt eine App mit diesem Hinweis auf insgesamt 100 neue Nutzer. Eine persönliche n8n-Installation erreicht diese Zahl praktisch nie.

Produktions-Tokens können trotzdem ihre Gültigkeit verlieren. Google akzeptiert ein Refresh-Token nicht mehr, wenn Sie den Zugriff der App in den Einstellungen Ihres Google-Kontos entfernen. Ein Refresh-Token mit Gmail-Scopes funktioniert ebenfalls nicht mehr, wenn sich das Kontopasswort ändert. Ein Token, das sechs Monate lang nicht verwendet wird, läuft ab. Google speichert außerdem höchstens 100 aktive Refresh-Tokens pro Konto und Client. Wenn Sie sich häufig anmelden, wird das älteste Token entfernt. In jedem dieser Fälle erscheint derselbe invalid_grant-Fehler. Die Lösung besteht darin, sich erneut anzumelden.

Ausweg B: Eine Internal-App in einer Google-Workspace-Domain

Wenn die Gmail-Adresse zu einer Google-Workspace-Domain gehört, erstellen Sie das Projekt innerhalb dieser Organisation und setzen Sie die Zielgruppe auf Internal. Google wendet die Sieben-Tage-Regel nur auf External-Apps im Status Testing an. Eine Internal-App ist davon nicht betroffen. Die Ausnahmen von der Google-Verifizierung gelten ebenfalls für die interne Nutzung. Eine App, die „nur von Personen in Ihrer Google-Workspace- oder Cloud-Identity-Organisation verwendet wird“, zeigt weder den Hinweis für nicht verifizierte Apps noch das Nutzerlimit an.

Das funktioniert nur, wenn sich das Projekt in der Organisation befindet und die anmeldende Person Mitglied dieser Organisation ist. Eine persönliche @gmail.com-Adresse kann keine Internal-App verwenden. Ihr Workspace-Administrator muss die angeforderten Gmail-Scopes möglicherweise trotzdem freigeben.

Ausweg C: IMAP und SMTP mit einem App-Passwort

Sie können OAuth vollständig umgehen. Gmail unterstützt IMAP (Internet Message Access Protocol) zum Lesen von E-Mails und SMTP (Simple Mail Transfer Protocol) zum Senden von E-Mails. Seit Januar 2025 ist IMAP für persönliche Gmail-Konten immer aktiviert. Es gibt daher keine Einstellung, die Sie ändern müssen. Google-Workspace-Administratoren können den IMAP-Zugriff für ihre Nutzer aktivieren oder deaktivieren.

Sie melden sich mit einem App-Passwort an. Dabei handelt es sich um einen 16-stelligen Code, den Google für eine einzelne App erzeugt. Für das Konto muss die Bestätigung in 2 Schritten aktiviert sein. Für Konten mit Advanced Protection bietet Google keine App-Passwörter an. Bei Arbeits- und Schulkonten hängt die Verfügbarkeit von den Einstellungen der Organisation ab. App-Passwörter sind außerdem nicht verfügbar, wenn die Bestätigung in 2 Schritten ausschließlich Sicherheitsschlüssel verwendet.

Lesen Sie E-Mails in n8n mit dem Node Email Trigger (IMAP) und einer IMAP-Anmeldedaten. Verwenden Sie den Host imap.gmail.com und Port 993 mit aktiviertem SSL/TLS. Senden Sie E-Mails mit dem Node Send Email und SMTP-Anmeldedaten. Verwenden Sie den Host smtp.gmail.com und Port 465 mit aktiviertem SSL/TLS. Der Benutzername ist die vollständige Gmail-Adresse. Das Passwort ist das App-Passwort ohne Leerzeichen.

Diese Option hat konkrete Nachteile. Ein App-Passwort ermöglicht den Zugriff auf das gesamte Postfach, und laut der Google-Hilfe werden App-Passwörter nicht empfohlen. Wenn Sie Ihr Google-Passwort ändern, widerruft Google alle App-Passwörter. Der Workflow bleibt dann stehen, bis Sie ein neues App-Passwort erstellen. Außerdem verlieren Sie die Gmail-spezifischen Filter des Gmail Trigger. IMAP stellt Gmail-Labels zudem als einfache Ordner dar.

Outlook: derselbe Callback in einer Microsoft-Entra-App

Microsoft Mail verwendet dasselbe Muster. n8n erstellt jeden OAuth2-Callback aus derselben Basis-URL der Instanz. Sobald der Gmail-Zugang die richtige Redirect-URL anzeigt, verwendet auch ein Microsoft-Zugang dieselbe URL.

Die Dokumentation zum Microsoft-Zugang von n8n beschreibt die Registrierung. Öffnen Sie die Seite für App-Registrierungen, die zu Microsoft Entra gehört, und erstellen Sie eine Registrierung mit einem Namen. Bei den unterstützten Kontotypen wählt die n8n-Dokumentation „Konten in einem beliebigen Organisationsverzeichnis (beliebiges Azure-AD-Verzeichnis – mandantenübergreifend) und persönliche Microsoft-Konten“. Setzen Sie die Plattform für die Redirect-URI auf Web und fügen Sie die OAuth Redirect URL von n8n ein. Kopieren Sie die Application (client) ID als Client-ID in n8n. Erstellen Sie im Bereich für Zertifikate und Geheimnisse ein Client Secret und kopieren Sie dessen Wert in n8n. Wenn eine Organisation das Microsoft-Konto verwaltet, muss ein Administrator die App möglicherweise zuerst genehmigen. Wählen Sie in n8n Connect my account, melden Sie sich bei Microsoft an und genehmigen Sie den Zugriff, um die Verbindung abzuschließen. Die Dokumentation von n8n behandelt außerdem die Zertifikatsauthentifizierung, Cloud-Umgebungen und dienstspezifische Einstellungen.

Welche Option sollten Sie wählen?

Für eine neue Anwendung, die nur ihr Ersteller verwendet, wählen Sie den Modus „Personal“. Wenn bereits eine „External“-Anwendung vorhanden ist, veröffentlichen Sie sie für die Produktion und fahren Sie einmal über den Bildschirm für nicht verifizierte Anwendungen hinaus. Für ein Workspace-Postfach verwenden Sie eine „Internal“-Anwendung. Wählen Sie IMAP mit einem App-Passwort, wenn Sie kein Google-Cloud-Projekt erstellen können oder wenn der Workflow nur E-Mails liest und sendet.

Sie benötigen dafür keinen kostenpflichtigen Tarif. Die Gmail-Nodes, der IMAP-Node und die OAuth-Anmeldedaten sind alle Bestandteil von der kostenlosen selbst gehosteten Community Edition von n8n. Wenn Sie noch prüfen, ob n8n zu Ihrer Arbeit passt, erklärt was n8n ist und wie seine Workflows ausgeführt werden die Grundlagen.

FAQ

Warum zeigt mein n8n-Gmail-Credential eine localhost-Weiterleitungs-URL?

n8n erstellt die OAuth-Weiterleitungs-URL aus N8N_EDITOR_BASE_URL. Wenn dieser Wert nicht gesetzt ist, verwendet n8n die Webhook-URL. Wenn beide Werte nicht gesetzt sind, erstellt n8n die URL aus N8N_PROTOCOL, N8N_HOST, N8N_PORT und N8N_PATH. Wenn keiner dieser Werte gesetzt ist, lautet das Ergebnis http://localhost:5678/rest/oauth2-credential/callback. Setzen Sie N8N_EDITOR_BASE_URL in der Container-Umgebung auf Ihre öffentliche https://-Adresse. Erstellen Sie den Container anschließend mit docker compose up -d neu und öffnen Sie das Credential erneut.

Warum hat mein n8n-Gmail-Trigger nach sieben Tagen aufgehört zu funktionieren?

Prüfen Sie, ob Ihre Google-App den Typ External hat und sich weiterhin im Status Testing befindet. Bei dieser Zielgruppe und diesem Veröffentlichungsstatus lässt Google die Gmail-Autorisierung eines Testbenutzers sieben Tage nach der Zustimmung ablaufen. Das Refresh-Token von n8n funktioniert dann nicht mehr, und jede Abfrage schlägt mit invalid_grant fehl. Eine erneute Anmeldung startet lediglich einen weiteren Zeitraum von sieben Tagen. Veröffentlichen Sie die External-App für die Produktion und melden Sie sich erneut an, um diese Begrenzung zu vermeiden. Für Personal mode und Internal-Apps gilt die Begrenzung von sieben Tagen für Test-Token nicht. Weder der Zeitpunkt noch invalid_grant allein belegen die Ursache: Auch widerrufener Zugriff, Token-Limits und Passwortänderungen bei Gmail-Scopes machen Refresh-Tokens ungültig.

Benötige ich eine Google-Verifizierung, um Gmail mit selbst gehostetem n8n zu verwenden?

Nicht für Personal mode oder eine App mit Limited Audience. n8n fordert eingeschränkte Gmail-Scopes an, und eine öffentliche App mit eingeschränkten Scopes muss verifiziert werden. Personal mode ist auf das Google-Konto des Erstellers beschränkt und zeigt keine Warnung für nicht verifizierte Apps an. Die separate Ausnahme für Limited Audience gilt für Apps, die für weniger als 100 Benutzer vorgesehen sind. Bei einer nicht verifizierten External-App wird der Bildschirm "Google hasn't verified this app" angezeigt. Sie können ihn überspringen und mit Ihrer eigenen App fortfahren.

Benötigt der Gmail-Trigger eine öffentliche Webhook-URL?

Nein. Der Gmail Trigger fragt Gmail nach dem Zeitplan unter Poll Times ab. Google ruft Ihren Server daher nie auf. Der OAuth-Callback ist eine Browser-Weiterleitung. Ihr eigener Browser muss die Callback-URL bei der Anmeldung erreichen können. Außerdem muss diese URL mit der beim Google-Client registrierten URL übereinstimmen.

War dieser Artikel hilfreich?

#n8n#gmail#google-oauth#self-hosting#automation