Come installare Node.js su un VPS Ubuntu o Debian?
Installare una versione LTS recente di Node.js con NodeSource o nvm su Ubuntu 24.04 e Debian 12, mantenere l’applicazione online con PM2 e riavviarla
Il pacchetto nodejs dei repository ufficiali installa Node.js 18 sia su Ubuntu 24.04 sia su Debian 12, una versione senza correzioni da aprile 2025. Per un’applicazione o un bot in produzione installate una versione LTS: Node.js 26 è la LTS attiva al 17 novembre 2026, Node.js 24 resta mantenuta. I comandi di questa guida sono stati provati su Ubuntu 24.04 e Debian 12.
Procedura passo passo
-
Scegli il metodo
NodeSource aggiunge un repository APT: una sola versione per tutto il sistema, aggiornata con apt upgrade. nvm installa Node.js nella cartella di un utente e permette di tenere più versioni affiancate. Per un solo servizio basta NodeSource; per più progetti con versioni diverse scegliete nvm.
-
Installare con NodeSource
Da root, scaricate lo script setup_26.x, leggetelo se volete, eseguitelo con bash e poi lanciate apt install -y nodejs. Il pacchetto include già npm: non installate anche il pacchetto npm della distribuzione.
-
Oppure installare con nvm
Collegati con l’utente che eseguirà l’applicazione, installate prima curl e libatomic1, poi lanciate lo script di installazione di nvm v0.41.0. Ricaricate la shell con source ~/.bashrc, quindi nvm install --lts installa l’ultima LTS e la imposta come predefinita.
-
Verificare le versioni
node -v deve mostrare v26 seguito dal numero di patch e npm -v una versione 11. Se node -v mostra ancora v18, il vecchio pacchetto della distribuzione ha la precedenza: which node indica il binario usato.
-
Avviare l’applicazione con PM2
Installate PM2 con npm install -g pm2, spostatevi nella cartella del progetto e lanciate pm2 start index.js --name app. PM2 riavvia il processo se si blocca; pm2 logs app mostra il suo output e pm2 restart app lo riavvia dopo un aggiornamento del codice.
-
Riavviare all’avvio del VPS
pm2 startup crea un servizio systemd; con un utente non root mostra un comando sudo env PATH= da copiare così com’è. Lanciate poi pm2 save per registrare l’elenco dei processi che PM2 ripristinerà dopo un riavvio.
Node.js 26 LTS con NodeSource (root)
apt update && apt install -y curl
curl -fsSL https://deb.nodesource.com/setup_26.x -o nodesource_setup.sh
bash nodesource_setup.sh
apt install -y nodejs
node -v
npm -v
Node.js con nvm (utente dell’applicazione)
sudo apt install -y curl libatomic1
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.41.0/install.sh | bash
source ~/.bashrc
nvm install --lts
nvm install 24
nvm alias default 26
nvm ls
PM2: avviare, seguire e riavviare al boot
npm install -g pm2
cd ~/app
pm2 start index.js --name app
pm2 list
pm2 logs app --lines 50
pm2 startup
pm2 save
Prima di iniziare
Servono un accesso SSH al VPS e un utente dedicato all’applicazione invece di root: adduser app lo crea. Se apt install nodejs è già stato lanciato, rimuovete quella vecchia versione con apt remove nodejs prima di passare a NodeSource o nvm, così due binari non entrano in conflitto.
- Un’applicazione Node.js semplice o un bot Discord gira con meno di 200 MB di RAM; installare le dipendenze con npm ne richiede di più per qualche secondo.
- Il campo engines di package.json o un file .nvmrc indica la versione attesa dal progetto.
Più versioni con nvm
nvm install 24 aggiunge Node.js 24 accanto alla 26, nvm use 24 cambia la shell corrente e nvm alias default 26 sceglie la versione delle nuove shell. In una cartella che contiene un file .nvmrc con 24, nvm use senza argomenti carica la versione giusta. Le versioni installate da nvm stanno in ~/.nvm: esistono solo per quell’utente, e un servizio systemd o un cron deve richiamare il percorso completo del binario, oppure passare da PM2.
Aprire l’applicazione su Internet
Un bot Discord non ha bisogno di alcuna porta in entrata: si collega lui stesso a Discord. Un’API o un sito, invece, ascolta su una porta come la 3000. La soluzione più pulita è lasciarlo su 127.0.0.1 e mettere Nginx davanti, con un certificato Let’s Encrypt; altrimenti aprite la porta in UFW e nel firewall del pannello.
Errori comuni e soluzioni
La maggior parte degli errori deriva da una versione di Node.js diversa da quella attesa, o da una shell che non ha caricato nvm.
- nvm: command not found subito dopo l’installazione: la shell non ha ancora letto ~/.bashrc. Lanciate source ~/.bashrc o aprite una nuova sessione SSH.
- node: error while loading shared libraries: libatomic.so.1 con nvm: la libreria manca su un’installazione minima. apt install libatomic1 corregge l’errore, senza reinstallare Node.js.
- npm ERR! code EACCES su npm install -g: la cartella globale appartiene a root. Con NodeSource installate gli strumenti globali da root; con nvm lanciate il comando senza sudo.
- SyntaxError: Unexpected token o ERR_REQUIRE_ESM all’avvio: il progetto richiede una versione più recente. Confrontate node -v con il campo engines di package.json.
- L’applicazione non riparte dopo un riavvio del VPS: pm2 save non è stato lanciato dopo l’ultimo pm2 start, oppure il comando mostrato da pm2 startup non è stato eseguito.
VPS o hosting per bot?
Per un solo bot Discord in Node.js, l’hosting per bot di ACLClouds evita tutta questa installazione: caricate il codice, il pannello installa le dipendenze, esegue il bot 24/7 e lo riavvia se si blocca. Il piano gratuito (315 MB di RAM) accetta Node.js e Python; il piano Starter costa 2,99 € al mese, oppure 2,39 € al mese con un impegno di un anno (prezzi al 17 novembre 2026).
Il VPS ha senso per più applicazioni, un’API con il suo database o un bisogno di controllo completo. Il VPS Mini (2 vCPU, 8 GB di RAM, 40 GB di storage) costa 4,99 € al mese senza vincolo, oppure 3,99 € al mese con un impegno di un anno, con una rete fino a 1 Gbit/s.
Verifica rapida
- node -v mostra una versione LTS (v26 o v24).
- pm2 list mostra l’applicazione in online.
- L’applicazione riparte da sola dopo un riavvio del VPS.
- L’applicazione non gira come root.
Domande frequenti
Perché non installare Node.js con apt install nodejs?
I repository di Ubuntu 24.04 e Debian 12 forniscono Node.js 18, il cui supporto è terminato ad aprile 2025, e molte librerie recenti, come Vite 8 o ESLint 10, richiedono una versione più nuova. NodeSource o nvm installano una LTS mantenuta.
NodeSource o nvm: quale scegliere?
NodeSource è adatto a un server che esegue una sola applicazione: Node.js è disponibile per tutti gli utenti e si aggiorna con il resto del sistema. nvm è adatto quando più progetti richiedono versioni diverse, o per provare una nuova versione senza toccare quella in produzione.
Come aggiornare Node.js a una nuova LTS?
Con NodeSource, apt upgrade applica le correzioni della stessa versione principale; per cambiare versione principale, rilanciate lo script della nuova versione e poi apt install nodejs. Con nvm, nvm install --lts --reinstall-packages-from=current installa la nuova LTS e vi ricopia i pacchetti globali, PM2 compreso. Riavviate poi l’applicazione e controllate i log.
PM2 o systemd per mantenere l’applicazione online?
Entrambi riavviano il processo dopo un crash e all’avvio del VPS. PM2 è più semplice per più applicazioni Node.js, con pm2 list, pm2 logs e la modalità cluster; systemd non aggiunge strumenti ed è adatto a un servizio unico. Evitate di combinarli per la stessa applicazione.