> ## Documentation Index
> Fetch the complete documentation index at: https://chariow.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation n8n

> Installez et configurez le node Chariow sur votre instance n8n auto-hébergée

Ce guide vous accompagne dans l'installation du node communautaire Chariow sur une instance n8n auto-hébergée et sa connexion à votre boutique.

## Prérequis

Avant de commencer, assurez-vous d'avoir :

* Une **instance n8n auto-hébergée** (v1.0 ou ultérieure)
* Une **clé API Chariow** (commence par `sk_`) — générez-en une depuis **Paramètres** → **Clés API** dans votre [Tableau de bord Chariow](https://app.chariow.com)
* **Node.js >= 18.10** sur la machine exécutant n8n

***

## Installation

<Warning>
  Le node Chariow n'est pas encore disponible via l'interface Community Nodes de n8n. Vous devez l'installer manuellement en utilisant l'une des méthodes ci-dessous.
</Warning>

### npm (recommandé)

Exécutez la commande suivante dans votre répertoire utilisateur n8n :

```bash theme={null}
cd ~/.n8n && npm install @chariow/n8n-nodes-chariow
```

Puis redémarrez n8n pour que le node apparaisse.

### Docker

Si vous exécutez n8n dans Docker, définissez la variable d'environnement `N8N_CUSTOM_EXTENSIONS` pour installer le package au démarrage :

```yaml theme={null}
# docker-compose.yml
services:
  n8n:
    image: n8nio/n8n
    environment:
      - N8N_CUSTOM_EXTENSIONS=@chariow/n8n-nodes-chariow
    # ... votre autre configuration
```

Redémarrez le conteneur après avoir mis à jour la configuration.

<Info>
  Le support via l'interface Community Nodes est prévu. Une fois disponible, vous pourrez installer directement depuis **Paramètres** → **Community Nodes** dans n8n.
</Info>

***

## Configurer les identifiants

<Steps>
  <Step title="Ouvrir les identifiants">
    Dans n8n, allez dans **Settings** → **Credentials** → **Add Credential**.
  </Step>

  <Step title="Rechercher Chariow">
    Recherchez **Chariow API** et sélectionnez-le.
  </Step>

  <Step title="Entrer votre clé API">
    Collez votre clé API Chariow (commence par `sk_`) dans le champ **API Key**.
  </Step>

  <Step title="Enregistrer">
    Cliquez sur **Save**. n8n testera la connexion automatiquement. Une coche verte confirme que votre clé est valide.
  </Step>
</Steps>

***

## Vérifier l'installation

<Steps>
  <Step title="Créer un nouveau workflow">
    Cliquez sur **New Workflow** dans n8n.
  </Step>

  <Step title="Ajouter un node">
    Cliquez sur **+** pour ajouter un node et recherchez **Chariow**.
  </Step>

  <Step title="Confirmer que les deux nodes apparaissent">
    Vous devriez voir deux nodes :

    * **Chariow** — pour effectuer des actions (obtenir, lister, créer)
    * **Chariow Trigger** — pour démarrer des workflows à partir des événements de votre boutique
  </Step>
</Steps>

***

## Dépannage

<AccordionGroup>
  <Accordion title="Les nodes n'apparaissent pas après l'installation">
    * Assurez-vous d'avoir installé le package dans le bon répertoire (`~/.n8n` pour les installations npm)
    * Redémarrez n8n complètement après l'installation
    * Vérifiez les logs n8n pour toute erreur d'installation : `docker logs n8n` ou vérifiez la sortie de votre processus
    * Vérifiez que le package est installé : `ls ~/.n8n/node_modules/@chariow`
  </Accordion>

  <Accordion title="Le test des identifiants a échoué">
    * Confirmez que votre clé API commence par `sk_` et est copiée en entier
    * Vérifiez que votre boutique est active dans le tableau de bord Chariow
    * Assurez-vous que votre instance n8n peut atteindre `https://api.chariow.com` (aucun pare-feu ou proxy bloquant)
  </Accordion>

  <Accordion title="Problèmes avec le conteneur Docker">
    * Vérifiez que la variable d'environnement `N8N_CUSTOM_EXTENSIONS` est correctement définie
    * Reconstruisez et redémarrez le conteneur : `docker compose down && docker compose up -d`
    * Vérifiez les logs du conteneur pour les erreurs d'installation npm : `docker logs <nom_du_conteneur>`
  </Accordion>
</AccordionGroup>

***

## Prochaines étapes

<CardGroup cols={2}>
  <Card title="Ressources disponibles" icon="database" href="/fr/n8n/overview#ressources-du-node-chariow">
    Découvrez toutes les ressources et opérations
  </Card>

  <Card title="Événements déclencheurs" icon="bolt" href="/fr/n8n/overview#événements-déclencheurs">
    Parcourez les 8 événements déclencheurs disponibles
  </Card>
</CardGroup>