# Den formbase-Node in n8n installieren

Gib einem selbst gehosteten n8n eine öffentliche HTTPS-Adresse, installiere den Community-Node n8n-nodes-formbase, und prüfe, dass seine Trigger und Aktionen erscheinen.

## 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.

<p>
  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.
</p>

<h2 id="before-you-start">Bevor du startest</h2>

<ul>
  <li>n8n 2.30 oder neuer. Das brauchen die formbase-Anmeldedaten.</li>
  <li>
    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.
  </li>
</ul>

<h2 id="self-hosted">Selbst gehostetes n8n</h2>

<p>Ein selbst gehostetes n8n braucht zwei Dinge, bevor es den Node installieren kann:</p>

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

<h3 id="public-address">1. n8n seine öffentliche Adresse mitteilen</h3>

<p>
  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:
</p>

<ul>
  <li>
    <code>WEBHOOK_URL</code>: die öffentliche HTTPS-Adresse, mit abschließendem Schrägstrich, wie <code>https://n8n.example.com/</code>.
    Daraus baut n8n die URL eines veröffentlichten Triggers und die Resume-URL von{' '}
    <a href="/de/guides/n8n/request-outcome#wait-for-the-outcome">Wait for the Outcome</a>.
  </li>
  <li>
    <code>N8N_EDITOR_BASE_URL</code>: dieselbe Adresse. n8n baut daraus die Test-URL eines Triggers für <strong>Execute step</strong>, und
    die <strong>OAuth Redirect URL</strong> der formbase-Anmeldedaten.
  </li>
  <li>
    <code>N8N_PROXY_HOPS</code>: setze es auf <code>1</code>, wenn n8n hinter einem Reverse-Proxy oder Tunnel läuft, damit n8n dessen
    weitergeleitete Header liest.
  </li>
</ul>

<p>Mit Docker sieht das so aus:</p>

```
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
```

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

> ⚠️ **VALIDATION_ERROR: targetUrl must use https**
> <p>
>     formbase weigert sich, Events an eine <code>http://</code>-URL oder eine private Netzwerkadresse zu senden. Zeigt ein Trigger diesen
>     Fehler bei <strong>Execute step</strong>, ist <code>N8N_EDITOR_BASE_URL</code> nicht gesetzt; bei <strong>Publish</strong> ist es{' '}
>     <code>WEBHOOK_URL</code>. Setze die Variable, starte n8n neu, und versuch es erneut. Änderst du <code>WEBHOOK_URL</code> später,
>     deaktiviere jeden formbase-Workflow und veröffentliche ihn erneut, damit sein Trigger die neue Adresse registriert.
>   </p>

<h3 id="install">2. Den Community-Node installieren</h3>

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

<p>Nach ein paar Sekunden erscheint das Paket in der Liste mit seinen zwei Nodes:</p>

<p>
  Aktualisiere oder deinstalliere das Paket aus derselben Liste. Fehlt <strong>Community nodes</strong> in Settings, wurde dein n8n mit{' '}
  <code>N8N_COMMUNITY_PACKAGES_ENABLED=false</code> gestartet; entferne diese Einstellung.
</p>

<h2 id="n8n-cloud">n8n Cloud</h2>

> ℹ️ **Auf n8n Cloud noch nicht verfügbar**
> <p>
>     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 <a href="/de/guides/rest-api/send-a-request">REST API</a> aus einem{' '}
>     <strong>HTTP Request</strong>-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.
>   </p>

<h2 id="check">Den Node prüfen</h2>

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

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

<h2 id="next">Als Nächstes</h2>

<div class="not-prose grid gap-3 sm:grid-cols-2 mb-8">
  - [formbase mit n8n verbinden](/de/guides/n8n/connect) — Die Anmeldedaten erstellen, dich anmelden und den Workspace wählen.
  - [Alle Anleitungen](/de/guides/overview)
</div>