Étape 1 — Service via marketplace

Coolify → Projects → « + New Resource » → One-Click Service → « n8n »
Service Name : n8n-prod
Domain : https://n8n.exemple.sn
Coolify configure auto Postgres, Redis (queue), variables sécurité
Storage : Persistent Volume sur /home/node/.n8n
Variables critiques :
- N8N_ENCRYPTION_KEY : 32+ caractères aléatoires (NE PAS PERDRE – chiffre vos credentials)
- N8N_HOST : n8n.exemple.sn
- N8N_PROTOCOL : https
- WEBHOOK_URL : https://n8n.exemple.sn/
Deploy

Étape 2 — Premier accès

Ouvrir https://n8n.exemple.sn
Créer le compte owner (premier user = owner)
Activer 2FA dans Settings → Security

Étape 3 — Configurer SMTP

Pour les workflows qui envoient emails, ajouter ces variables d’env :

N8N_EMAIL_MODE=smtp
N8N_SMTP_HOST=smtp-relay.brevo.com
N8N_SMTP_PORT=587
N8N_SMTP_USER=votre-login
N8N_SMTP_PASS=votre-key
N8N_SMTP_SENDER=alerts@exemple.sn

Étape 4 — Mode queue (production)

Pour gros volumes, activer le mode queue avec Redis :

EXECUTIONS_MODE=queue
QUEUE_BULL_REDIS_HOST=n8n-redis
QUEUE_BULL_REDIS_PORT=6379
QUEUE_BULL_REDIS_PASSWORD=...

n8n traite les workflows via workers Bull. Plusieurs workers possibles pour scaler.

Étape 5 — Backup

Le backup Coolify Postgres couvre les workflows et exécutions. En complément, exporter les workflows en JSON via l’UI ou API pour version control Git.

Erreurs fréquentes

Erreur	Cause	Solution
Webhook URL incorrecte	WEBHOOK_URL pas set	Définir variable d’env
Credentials décryptables après restore	Encryption key changée	Garder N8N_ENCRYPTION_KEY identique
Slow execution	Pas de mode queue	Activer Redis + workers