Anleitungen · n8n (selbst gehostet)

Den formbase-Node in n8n installieren

formbase für n8n ist ein Community-Node, auf npm veröffentlicht als n8n-nodes-formbase. Diese Anleitung installiert ihn auf einem selbst gehosteten n8n und setzt die Adresse, über die formbase deine Workflows erreicht.

Last checked September 28, 2026

Jede n8n-Anleitung wurde auf einem selbst gehosteten n8n 2.40 geprüft, in Docker laufend, mit Version 0.10.1 des Nodes. Alles, was davon abhängt, wo n8n läuft, steht auf dieser Seite. Die anderen Anleitungen funktionieren gleich, sobald der Node installiert ist.

Bevor du startest

n8n 2.30 oder neuer. Das brauchen die formbase-Anmeldedaten.
Ein formbase-Konto. Alles in diesen Anleitungen funktioniert im Free-Plan, außer E-Mail-Einladungen, Erinnerungen und abgebrochene Einreichungen, die Pro oder Business brauchen.

Selbst gehostetes n8n

Ein selbst gehostetes n8n braucht zwei Dinge, bevor es den Node installieren kann:

Das Owner-Konto oder ein Admin-Konto. Nur der Owner und Admins können Community-Nodes installieren.
Eine öffentliche HTTPS-Adresse, von einem Reverse-Proxy oder einem Tunnel. formbase sendet Events und Request-Callbacks nur an https://-URLs im öffentlichen Internet. Ein n8n, das nur über localhost erreichbar ist, kann sich verbinden, empfängt aber nie etwas.

1. n8n seine öffentliche Adresse mitteilen

n8n baut die URLs, die es an formbase übergibt, aus seinen eigenen Einstellungen, nicht aus der Adresse in deinem Browser. Setze diese Umgebungsvariablen im n8n-Container oder -Prozess:

WEBHOOK_URL: die öffentliche HTTPS-Adresse, mit abschließendem Schrägstrich, wie https://n8n.example.com/. Daraus baut n8n die URL eines veröffentlichten Triggers und die Resume-URL von Wait for the Outcome.
N8N_EDITOR_BASE_URL: dieselbe Adresse. n8n baut daraus die Test-URL eines Triggers für Execute step, und die OAuth Redirect URL der formbase-Anmeldedaten.
N8N_PROXY_HOPS: setze es auf 1, wenn n8n hinter einem Reverse-Proxy oder Tunnel läuft, damit n8n dessen weitergeleitete Header liest.

Mit Docker sieht das so aus:

bash

docker run -d --name n8n -p 5678:5678 \
  -e WEBHOOK_URL=https://n8n.example.com/ \
  -e N8N_EDITOR_BASE_URL=https://n8n.example.com/ \
  -e N8N_PROXY_HOPS=1 \
  -v n8n_data:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

Bei docker compose oder einer npm-Installation setze dieselben Variablen in der n8n-Umgebung. Richte deinen Proxy oder Tunnel auf Port 5678, leite /webhook/, /webhook-test/ und /webhook-waiting/ unverändert durch, und öffne n8n von da an über die öffentliche Adresse.

VALIDATION_ERROR: targetUrl must use https

formbase weigert sich, Events an eine http://-URL oder eine private Netzwerkadresse zu senden. Zeigt ein Trigger diesen Fehler bei Execute step, ist N8N_EDITOR_BASE_URL nicht gesetzt; bei Publish ist es WEBHOOK_URL. Setze die Variable, starte n8n neu, und versuch es erneut. Änderst du WEBHOOK_URL später, deaktiviere jeden formbase-Workflow und veröffentliche ihn erneut, damit sein Trigger die neue Adresse registriert.

2. Den Community-Node installieren

Öffne Settings › Community nodes und klicke auf Install. Trag n8n-nodes-formbase unter npm Package Name ein, setz das Häkchen, das bestätigt, dass du die Risiken der Installation unverifizierten Codes verstehst, und klicke auf Install.

Der Dialog Install community nodes: npm Package Name n8n-nodes-formbase, die Risiko-Checkbox angehakt, und ein Install-Button

Nach ein paar Sekunden erscheint das Paket in der Liste mit seinen zwei Nodes:

Settings › Community nodes listet n8n-nodes-formbase, Version 0.10.1, mit 2 Nodes: formbase, formbase Trigger

Aktualisiere oder deinstalliere das Paket aus derselben Liste. Fehlt Community nodes in Settings, wurde dein n8n mit N8N_COMMUNITY_PACKAGES_ENABLED=false gestartet; entferne diese Einstellung.

n8n Cloud

Auf n8n Cloud noch nicht verfügbar

n8n Cloud installiert nur Community-Nodes, die n8n verifiziert hat, und der formbase-Node ist noch nicht verifiziert. Nutze bis dahin ein selbst gehostetes n8n, oder ruf die REST API aus einem HTTP Request-Node auf. Eine Cloud-Instanz hat bereits eine öffentliche HTTPS-Adresse, sobald der Node dort verfügbar ist, ändern sich also nur die Installationsschritte auf dieser Seite.

Den Node prüfen

Öffne einen Workflow, klicke auf + und suche nach formbase. Die Node-Details zeigen sechs Aktionen und sechs Trigger:

Die Node-Details von formbase, markiert Installed, mit Actions (6): Cancel request, Create request, Get request, Get many requests, Remind request recipient und Replay request callback, und einer eingeklappten Triggers-(6)-Sektion

formbase Trigger startet einen Workflow bei einer erstellten, bearbeiteten oder abgebrochenen Einreichung über den Freigabelink, oder bei einem abgeschlossenen, abgelaufenen oder stornierten Request.
formbase erstellt einen Request, liest einen oder mehrere, erinnert die empfangende Person, storniert einen Request, und spielt seinen Callback erneut ab.

Als Nächstes

formbase mit n8n verbindenDie Anmeldedaten erstellen, dich anmelden und den Workspace wählen.Alle Anleitungen