Auto-héberger n8n sur Square Cloud

​

Introduction

• Cet article vous guide à travers la création et l’hébergement d’une application n8n sur Square Cloud.
• Avant de commencer, assurez-vous d’avoir un compte sur Square Cloud, que vous pouvez créer avec votre e-mail sur la page d’inscription.
• Enfin, vous devez disposer d’un plan actif avec au moins 4 Go de RAM sur votre compte, comme Standard : n8n tourne avec 3 Go (MEMORY=3072 ci-dessous) et les plans plus petits n’ont pas autant de RAM. Comparez les plans disponibles et choisissez-en un selon vos besoins.

​

Création du projet

• n8n s’exécute sur Node.js : le projet n’a donc besoin que d’un package.json.
• Le package.json liste n8n dans ses dépendances et contient un script pour le démarrer. Voici l’exemple :

{
  "name": "squarecloud-n8n",
  "version": "1.0.0",
  "main": "index.js",
  "type": "module",
  "scripts": {
    "start": "n8n"
  },
  "author": "Square Cloud Education <squarecloud.app>",
  "license": "ISC",
  "dependencies": {
    "n8n": "2.41.3"
  }
}

• La version de n8n est fixée volontairement : latest peut passer à une nouvelle version majeure avec des changements incompatibles à chaque réinstallation. n8n 2.x nécessite Node.js 24 ou plus récent, ce que fournit VERSION=recommended.
• Pour mettre à jour plus tard, vérifiez la version la plus récente avec npm view n8n version, lisez les notes de version de n8n, modifiez la version dans package.json et téléversez à nouveau votre projet.

​

Fichiers de votre ZIP

• package.json
• squarecloud.app (le fichier de configuration ci-dessous)
• .env (optionnel, avec les variables ci-dessous)

​

Fichier de configuration

• Lors d’un envoi depuis le tableau de bord, définissez manuellement le runtime sur Node.js et utilisez npm run start comme commande de démarrage. Dans un fichier de configuration squarecloud.app, cela ressemble à ceci :

DISPLAY_NAME=App name
RUNTIME=nodejs
START=npm run start
MEMORY=3072
VERSION=recommended
SUBDOMAIN=my-n8n-subdomain

• La valeur MEMORY ci-dessus suit les règles de dimensionnement de la plateforme : consultez pourquoi des minimums de RAM existent si vous souhaitez l’ajuster.
• Définissez ensuite les variables d’environnement ci-dessous. Vous pouvez les placer dans un fichier .env à la racine du projet (n8n le charge au démarrage) ou les définir dans la Configuration avancée du formulaire d’envoi. Remplacez my-n8n-subdomain par votre SUBDOMAIN.

N8N_PORT=80
N8N_LISTEN_ADDRESS=0.0.0.0
N8N_HOST=my-n8n-subdomain.squareweb.app
N8N_PROTOCOL=https
N8N_WEBHOOK_URL=https://my-n8n-subdomain.squareweb.app/

• N8N_PORT et N8N_LISTEN_ADDRESS font écouter n8n sur le port 80 sur toutes les interfaces, là où Square Cloud achemine le trafic de votre sous-domaine. n8n ne lit pas la variable PORT que définit Square Cloud : N8N_PORT est donc obligatoire.
• N8N_HOST, N8N_PROTOCOL et N8N_WEBHOOK_URL indiquent à n8n son adresse publique. Sans N8N_WEBHOOK_URL, les URL de webhook que n8n affiche dans vos workflows pointent vers le port interne et les services externes ne peuvent pas les atteindre. D’anciens guides appellent cette variable WEBHOOK_URL, que n8n 2.x rend obsolète. Consultez les variables d’endpoint de n8n pour plus d’options.
• Les variables définies dans le tableau de bord ont la priorité sur le fichier .env. Consultez Variables d’environnement pour savoir comment les gérer.

​

Téléversement du projet sur Square Cloud

​

Via le tableau de bord

1

Accéder à la page d'upload

Accédez à la page d’upload et téléversez le fichier zip de votre projet.

2

Configurer votre environnement

Après avoir téléversé votre zip, vous devrez configurer le nom, le fichier principal ou l’environnement d’exécution ainsi que d’autres paramètres de votre projet.
Si vous téléversez un projet web, veillez à sélectionner « Publication Web » et à définir un sous-domaine pour votre projet.

3

Déployer votre projet

Enfin, cliquez sur le bouton « Deploy » pour héberger votre projet sur Square Cloud.
Une fois le déploiement effectué, vous pouvez suivre l’état et les logs de votre projet depuis le tableau de bord.

4

Confirmez que votre application est en ligne

Votre premier déploiement prend généralement moins d’une minute. Dans le tableau de bord, attendez que le statut de votre application affiche « en cours d’exécution » et vérifiez les logs pour détecter d’éventuelles erreurs de démarrage.
Si vous avez déployé un site web ou une API, ouvrez https://<votre-sous-domaine>.squareweb.app dans votre navigateur, vous devriez voir votre application répondre. Si vous avez déployé un bot, envoyez-lui une commande pour confirmer qu’il est en ligne.

Votre application ne démarre pas ? Consultez le guide de dépannage pour les causes les plus courantes et leurs solutions.

​

Via la CLI

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

squarecloud upload --file <path/to/zip>

squarecloud app status
squarecloud app logs

​

Création du compte propriétaire

​

Considérations finales

​

Prochaines étapes

​

Contactez-nous