Self-hosting di n8n su Square Cloud

​

Introduzione

• Questo articolo ti guida nella creazione e nell’hosting di un’applicazione n8n su Square Cloud.
• Prima di iniziare, assicurati di avere un account su Square Cloud, che puoi creare con la tua email nella pagina di registrazione.
• Infine, devi avere un piano attivo con almeno 4GB di RAM sul tuo account, come lo Standard: n8n gira con 3GB (MEMORY=3072 qui sotto) e i piani più piccoli non hanno così tanta RAM. Confronta i piani disponibili e scegline uno in base alle tue esigenze.

​

Creazione del progetto

• n8n gira su Node.js, quindi al progetto serve solo un package.json.
• Il package.json elenca n8n tra le dipendenze e ha uno script per avviarlo. Ecco l’esempio:

{
  "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 versione di n8n è fissata di proposito: latest può saltare a una nuova versione major con modifiche incompatibili a ogni reinstallazione. n8n 2.x richiede Node.js 24 o superiore, fornito da VERSION=recommended.
• Per aggiornare in seguito, controlla la versione più recente con npm view n8n version, leggi le note di rilascio di n8n, cambia la versione nel package.json e carica di nuovo il tuo progetto.

​

File nello ZIP

• package.json
• squarecloud.app (il file di configurazione qui sotto)
• .env (opzionale, con le variabili qui sotto)

​

File di configurazione

• Quando carichi dalla dashboard, imposta manualmente il runtime su Node.js e usa npm run start come comando di avvio. In un file di configurazione squarecloud.app, appare così:

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

• Il valore di MEMORY sopra segue le regole di dimensionamento della piattaforma: consulta perché esistono i minimi di RAM se vuoi modificarlo.
• Poi imposta le variabili d’ambiente qui sotto. Puoi inserirle in un file .env nella radice del progetto (n8n lo carica all’avvio) oppure impostarle in Advanced configuration del modulo di upload. Sostituisci my-n8n-subdomain con il tuo 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 e N8N_LISTEN_ADDRESS fanno sì che n8n sia in ascolto sulla porta 80 su tutte le interfacce, dove Square Cloud consegna il traffico del tuo sottodominio. n8n non legge la variabile PORT impostata da Square Cloud, quindi N8N_PORT è obbligatoria.
• N8N_HOST, N8N_PROTOCOL e N8N_WEBHOOK_URL indicano a n8n il suo indirizzo pubblico. Senza N8N_WEBHOOK_URL, gli URL dei webhook che n8n mostra nei tuoi workflow puntano alla porta interna e i servizi esterni non riescono a raggiungerli. Le guide più vecchie chiamano questa variabile WEBHOOK_URL, deprecata in n8n 2.x. Consulta le variabili degli endpoint di n8n per altre opzioni.
• Le variabili impostate nella dashboard hanno la precedenza sul file .env. Consulta Variabili d’ambiente per sapere come gestirle.

​

Caricamento del progetto su Square Cloud

​

Tramite dashboard

1

Accedi alla pagina di upload

Accedi alla pagina di upload e carica il file zip del tuo progetto.

2

Configura il tuo ambiente

Dopo aver caricato il tuo zip, dovrai configurare il nome, il file principale o il runtime environment e altre impostazioni per il tuo progetto.
Se stai caricando un progetto web, assicurati di selezionare “Web Publication” e di impostare un sottodominio per il tuo progetto.

3

Esegui il deploy del tuo progetto

Infine, clicca sul pulsante “Deploy” per ospitare il tuo progetto su Square Cloud.
Dopo il deploy, puoi monitorare lo stato e i log del tuo progetto dalla dashboard.

4

Conferma che la tua app sia online

Il primo deploy richiede di solito meno di un minuto. Nella dashboard, attendi che lo stato della tua applicazione mostri “in esecuzione” e controlla i log per eventuali errori di avvio.
Se hai fatto il deploy di un sito web o di un’API, apri https://<tuo-sottodominio>.squareweb.app nel tuo browser: dovresti vedere la tua applicazione rispondere. Se hai fatto il deploy di un bot, invia un comando per confermare che sia online.

La tua app non si avvia? Consulta la guida alla risoluzione dei problemi per le cause più comuni e le relative soluzioni.

​

Tramite 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

​

Creazione dell’account owner

​

Considerazioni finali

​

Prossimi passi

​

Contattaci