App Node.js

Con un piano Hosting Node.js la tua app Node.js o Next.js gira sul nostro server, con il suo database e il suo Redis. Si gestisce dal pannello: Hosting → nome del sito → Applicazione.

Prima di iniziare

  • Nel package.json serve lo script start (per esempio "start": "node server.js"), oppure un comando di avvio che scegli tu.
  • L'app deve ascoltare sulla porta che riceve nella variabile PORT (process.env.PORT), sull'indirizzo 0.0.0.0.
  • Next.js: lo scegli quando acquisti il piano. Servono gli script build (next build) e start (next start).

Quando il sito nasce trovi un'app iniziale «Sito in costruzione» (package.json e server.js): sostituiscila con la tua.

Caricare l'app

Due modi:

  • FTP: carica i file nella cartella www del sito (FTP). Non caricare la cartella node_modules: le dipendenze le installiamo noi.
  • Git: collega il repository (Deploy da Git). A ogni aggiornamento installiamo le dipendenze e riavviamo l'app da soli. Una cartella www con dentro solo l'app iniziale vale come vuota: puoi collegare il repository senza svuotarla.

Installa e avvia

Dopo aver caricato l'app clicca Installa e avvia. Nell'ordine:

  1. installiamo le dipendenze: npm ci se c'è il package-lock.json, altrimenti npm install;
  2. se nel package.json c'è lo script build, eseguiamo npm run build;
  3. avviamo l'app con il comando di avvio.

Può richiedere qualche minuto: la pagina si aggiorna da sola finché non finisce. Accanto al titolo vedi lo stato dell'app: In esecuzione, In avvio o Ferma. Se l'installazione non riesce, apri Mostra l'output dell'installazione per leggere l'errore di npm.

Ripeti Installa e avvia ogni volta che cambi le dipendenze o il codice da compilare (con Git lo facciamo noi).

Versione e comando di avvio

In Versione e avvio:

  • Versione di Node.js: 20, 22 o 24. Cambiandola l'app si reinstalla da sola con la versione nuova.
  • Comando di avvio: per esempio npm start oppure node server.js. Sono ammessi lettere, cifre, spazi e i caratteri . _ / : = @ -.

Variabili d'ambiente

In Variabili d'ambiente aggiungi chiavi API e impostazioni: le salviamo nel file .env della cartella www, leggibile solo dal sito.

  • Next.js legge il .env da solo.
  • Node.js lo legge con node --env-file=.env server.js, oppure con il pacchetto dotenv.

Le variabili valgono dal prossimo Riavvia. Quelle che Next.js utilizza durante la compilazione valgono dalla prossima Installa e avvia. Un valore non può contenere insieme apici singoli e virgolette (o barre rovesciate).

Database e Redis

Ogni app ha il suo database MySQL (MariaDB) e il suo Redis, già collegati: l'app li riceve come variabili d'ambiente.

  • DB_HOST, DB_NAME, DB_USER, DB_PASSWORD
  • REDIS_HOST, REDIS_PORT, REDIS_PASSWORD

Le credenziali del database le trovi anche nel pannello, in Database.

Riavviare

Riavvia fa ripartire l'app, per esempio dopo aver cambiato le variabili d'ambiente.

Se l'app non parte

  • Controlla che ascolti su process.env.PORT: con una porta fissa diversa le visite non arrivano.
  • Controlla il comando di avvio e lo script start del package.json.
  • Leggi l'output dell'ultima installazione e il log dell'app, il file logs/node.log del sito, che trovi via FTP o nel pannello in File → File Manager.