# Installer le nœud formbase dans n8n

Donnez à un n8n auto-hébergé une adresse HTTPS publique, installez le nœud communautaire n8n-nodes-formbase, et vérifiez que ses déclencheurs et actions apparaissent.

## Installer le nœud formbase dans n8n

formbase pour n8n est un nœud communautaire, publié sur npm sous le nom n8n-nodes-formbase. Ce guide l'installe sur un n8n auto-hébergé et définit l'adresse que formbase utilise pour joindre vos workflows.

<p>
  Chaque guide n8n a été vérifié sur un n8n auto-hébergé 2.40, s'exécutant dans Docker, avec la version 0.10.1 du nœud. Tout ce qui dépend
  de l'endroit où n8n s'exécute se trouve sur cette page. Les autres guides fonctionnent de la même façon une fois le nœud installé.
</p>

<h2 id="before-you-start">Avant de commencer</h2>

<ul>
  <li>n8n 2.30 ou version ultérieure. Le credential formbase en a besoin.</li>
  <li>
    Un compte formbase. Tout ce que ces guides couvrent fonctionne sur le plan Free, sauf les invitations par e-mail, les rappels et les
    soumissions abandonnées, qui nécessitent Pro ou Business.
  </li>
</ul>

<h2 id="self-hosted">n8n auto-hébergé</h2>

<p>Un n8n auto-hébergé a besoin de deux choses avant de pouvoir installer le nœud :</p>

<ul>
  <li>
    Le compte propriétaire ou un compte administrateur. Seuls le propriétaire et les administrateurs peuvent installer des nœuds
    communautaires.
  </li>
  <li>
    Une adresse HTTPS publique, via un proxy inverse ou un tunnel. formbase n'envoie les événements et les callbacks de demande qu'à des URL
    en <code>https://</code> sur l'internet public. Un n8n accessible uniquement sur <code>localhost</code> peut se connecter mais ne reçoit
    jamais rien.
  </li>
</ul>

<h3 id="public-address">1. Indiquez à n8n son adresse publique</h3>

<p>
  n8n construit les URL qu'il transmet à formbase à partir de ses propres réglages, pas de l'adresse dans votre navigateur. Définissez ces
  variables d'environnement sur le conteneur ou le processus n8n :
</p>

<ul>
  <li>
    <code>WEBHOOK_URL</code> : l'adresse HTTPS publique, avec une barre oblique finale, comme <code>https://n8n.example.com/</code>. n8n en
    tire l'URL d'un déclencheur publié et l'URL de reprise de{' '}
    <a href="/fr/guides/n8n/request-outcome#wait-for-the-outcome">Wait for the Outcome</a>.
  </li>
  <li>
    <code>N8N_EDITOR_BASE_URL</code> : la même adresse. n8n en tire l'URL de test d'un déclencheur pour <strong>Execute step</strong>, ainsi
    que l'<strong>OAuth Redirect URL</strong> du credential formbase.
  </li>
  <li>
    <code>N8N_PROXY_HOPS</code> : mettez-le à <code>1</code> quand n8n s'exécute derrière un seul proxy inverse ou tunnel, pour que n8n lise
    les en-têtes transmis par le proxy.
  </li>
</ul>

<p>Avec Docker, cela ressemble à ceci :</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>
  Avec docker compose ou une installation npm, définissez les mêmes variables dans l'environnement de n8n. Pointez votre proxy ou tunnel
  vers le port <code>5678</code>, laissez passer <code>/webhook/</code>, <code>/webhook-test/</code> et <code>/webhook-waiting/</code> sans
  les modifier, et ouvrez n8n via l'adresse publique à partir de là.
</p>

> ⚠️ **VALIDATION_ERROR: targetUrl must use https**
> <p>
>     formbase refuse d'envoyer des événements à une URL en <code>http://</code> ou à une adresse de réseau privé. Si un déclencheur affiche
>     cette erreur sur <strong>Execute step</strong>, <code>N8N_EDITOR_BASE_URL</code> n'est pas défini ; sur <strong>Publish</strong>, c'est{' '}
>     <code>WEBHOOK_URL</code> qui ne l'est pas. Définissez cette variable, redémarrez n8n, et réessayez. Si vous changez{' '}
>     <code>WEBHOOK_URL</code> plus tard, dépubliez puis republiez chaque workflow formbase pour que son déclencheur enregistre la nouvelle
>     adresse.
>   </p>

<h3 id="install">2. Installez le nœud communautaire</h3>

<p>
  Ouvrez <strong>Settings</strong> › <strong>Community nodes</strong> et cliquez sur <strong>Install</strong>. Tapez{' '}
  <code>n8n-nodes-formbase</code> sous <strong>npm Package Name</strong>, cochez la case indiquant que vous comprenez les risques liés à
  l'installation de code non vérifié, et cliquez sur <strong>Install</strong>.
</p>

<p>Après quelques secondes, le package apparaît dans la liste avec ses deux nœuds :</p>

<p>
  Mettez à jour ou désinstallez le package depuis la même liste. Si <strong>Community nodes</strong> est absent de Settings, votre n8n a été
  démarré avec <code>N8N_COMMUNITY_PACKAGES_ENABLED=false</code> ; retirez ce réglage.
</p>

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

> ℹ️ **Pas encore disponible sur n8n Cloud**
> <p>
>     n8n Cloud n'installe que les nœuds communautaires vérifiés par n8n, et le nœud formbase ne l'est pas encore. En attendant, utilisez un
>     n8n auto-hébergé, ou appelez l'<a href="/fr/guides/rest-api/send-a-request">API REST</a> depuis un nœud <strong>HTTP Request</strong>.
>     Une instance Cloud a déjà une adresse HTTPS publique, donc une fois le nœud disponible là-bas, seules les étapes d'installation de cette
>     page changent.
>   </p>

<h2 id="check">Vérifiez le nœud</h2>

<p>
  Ouvrez un workflow, cliquez sur <strong>+</strong> et cherchez <strong>formbase</strong>. Les détails du nœud montrent six actions et six
  déclencheurs :
</p>

<ul>
  <li>
    <strong>formbase Trigger</strong> démarre un workflow sur une soumission par lien public créée, modifiée ou abandonnée, ou sur une
    demande terminée, expirée ou annulée.
  </li>
  <li>
    <strong>formbase</strong> crée une demande, en récupère une ou plusieurs, relance le destinataire, annule une demande, et rejoue son
    callback.
  </li>
</ul>

<h2 id="next">Suite</h2>

<div class="not-prose grid gap-3 sm:grid-cols-2 mb-8">
  - [Connecter formbase à n8n](/fr/guides/n8n/connect) — Créez le credential, connectez-vous, et choisissez l'espace de travail.
  - [Tous les guides](/fr/guides/overview)
</div>