/
mc-node.net →
VPS

Hoe installeer ik Node.js op mijn VPS?

Bijgewerkt op 07/11/20264 min. leestijd
In dit artikel
  1. Welke versie kies je?
  2. Voorbereiding: een oude versie opruimen
  3. Methode 1: NodeSource (aanbevolen)
  4. Methode 2: nvm (per gebruiker)
  5. De versie controleren
  6. Bijwerken
  7. Veelvoorkomende problemen
  8. Hulp nodig?

Node.js heb je nodig voor onder meer Discord-bots, webapps en moderne tools zoals AI-agents. Het voor de hand liggende apt install nodejs is daarvoor geen goed idee: Ubuntu en Debian leveren zo een oude versie. Op Ubuntu 24.04 krijg je Node.js 18, op Ubuntu 22.04 zelfs Node.js 12, en beide worden niet meer onderhouden door het Node.js-project. Veel actuele programma's starten er niet mee; OpenClaw vraagt bijvoorbeeld minimaal Node.js 24.16. In deze gids installeer je de actuele LTS-versie op een officiële manier en controleer je daarna de versie. De stappen zijn voor een Linux-VPS met Ubuntu of Debian; op een Windows VPS gebruik je de installer van nodejs.org.

Welke versie kies je?

Kies een LTS-versie (Long Term Support): die krijgt jarenlang beveiligingsupdates. Sinds 28 oktober 2026 is dat Node.js 26, de versie in de commando's hieronder. Node.js 24 krijgt nog onderhoud tot 30 april 2028; vraagt een programma specifiek om versie 24, vervang dan 26 door 24. Welke versies op dit moment LTS zijn, zie je op nodejs.org.

Er zijn twee officiële routes. Kies er één: beide door elkaar gebruiken geeft verwarring over welke node er draait.

  • NodeSource (aanbevolen voor een server): Node.js komt als gewoon pakket in /usr/bin/node, voor alle gebruikers en diensten, en updates krijg je mee met apt upgrade.
  • nvm (Node Version Manager): installeert Node.js per gebruiker in de thuismap. Handig als je meerdere versies naast elkaar wilt hebben. Deze methode staat ook op de downloadpagina van nodejs.org.

Voorbereiding: een oude versie opruimen

Verbind met je VPS via SSH (zie verbinden met de SSH van je VPS). Ben je als root ingelogd, dan mag sudo voor de commando's gewoon blijven staan. Kijk eerst of er al een Node.js op staat:

node -v

Krijg je command not found, ga dan meteen door naar een van de methodes. Zie je een oude versie, zoals v18.19.1 of v12.22.9, verwijder die dan eerst. Anders loopt de installatie vast op een conflict met het pakket libnode-dev:

sudo apt remove -y nodejs npm libnode-dev
sudo apt autoremove -y

Methode 1: NodeSource (aanbevolen)

Voer deze commando's na elkaar uit:

sudo apt update
sudo apt install -y curl
curl -fsSL https://deb.nodesource.com/setup_26.x -o nodesource_setup.sh
sudo -E bash nodesource_setup.sh
sudo apt install -y nodejs

Het script van NodeSource voegt hun pakketbron en ondertekeningssleutel toe aan apt; de laatste regel installeert Node.js. npm zit er al bij, dat installeer je niet apart. Wil je eerst zien wat het script doet, bekijk het dan vóór de vierde regel met less nodesource_setup.sh.

Methode 2: nvm (per gebruiker)

Log in als de gebruiker die Node.js gaat gebruiken, want nvm zet alles in diens thuismap. Op een kale installatie ontbreken soms curl en libatomic1 (zonder die laatste start Node.js niet), daarom installeert de eerste regel die:

sudo apt install -y curl libatomic1
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.41.0/install.sh | bash
\. "$HOME/.nvm/nvm.sh"
nvm install 26

De derde regel laadt nvm meteen in je huidige sessie; bij een volgende login gebeurt dat vanzelf. Het nieuwste versienummer van nvm (hier v0.41.0) vind je op GitHub.

Let op: een Node.js van nvm staat alleen in jouw thuismap. Een systemd-dienst of een andere gebruiker vindt hem niet vanzelf. Moet je bot of app als dienst draaien, dan is NodeSource handiger.

De versie controleren

node -v
npm -v

Je ziet nu bijvoorbeeld v26.13.0 en 11.20.0. Begint de Node-versie met v26 (of v24 als je die koos), dan ben je klaar.

Bijwerken

Bij NodeSource komen nieuwe versies binnen dezelfde reeks (bijvoorbeeld van 26.13 naar 26.14) mee met sudo apt update && sudo apt upgrade. Naar een nieuwe hoofdversie ga je door het setup-script van die versie te draaien en daarna opnieuw sudo apt install -y nodejs uit te voeren. Bij nvm haalt nvm install 26 de nieuwste 26.x binnen.

Veelvoorkomende problemen

  • trying to overwrite '/usr/include/node/common.gypi': de oude Node.js van Ubuntu staat er nog, samen met libnode-dev. Verwijder die met de commando's onder Voorbereiding en voer daarna sudo apt install -y nodejs opnieuw uit.
  • node -v toont nog de oude versie: je shell onthoudt het oude pad. Typ hash -r of log opnieuw in. Met which -a node zie je welke Node.js-installaties er zijn; staat er een in ~/.nvm, dan gaat die voor op die van NodeSource.
  • nvm: command not found: je huidige sessie kent nvm nog niet. Log opnieuw in of voer \. "$HOME/.nvm/nvm.sh" uit.
  • error while loading shared libraries: libatomic.so.1: installeer de ontbrekende bibliotheek met sudo apt install -y libatomic1.
  • Goedkope VPS (OpenVZ): de officiële Node.js-builds zijn bedoeld voor Linux-kernel 4.18 of nieuwer. Op OpenVZ deel je de kernel met de host; bekijk hem met uname -r. Is hij ouder, dan kan Node.js toch werken, maar officieel wordt het niet ondersteund. Voor zware Node-apps is een KVM VPS de veiligere keuze.

Hulp nodig?

Kom je er niet uit? Open een ticket via onze supportpagina en zet de uitvoer van node -v en de volledige foutmelding erbij.