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.jsonserve 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'indirizzo0.0.0.0. - Next.js: lo scegli quando acquisti il piano. Servono gli script
build(next build) estart(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:
- installiamo le dipendenze:
npm cise c'è ilpackage-lock.json, altrimentinpm install; - se nel
package.jsonc'è lo scriptbuild, eseguiamonpm run build; - 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 startoppurenode 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
.envda 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_PASSWORDREDIS_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
startdelpackage.json. - Leggi l'output dell'ultima installazione e il log dell'app, il file
logs/node.logdel sito, che trovi via FTP o nel pannello in File → File Manager.