Wie installiere ich Node.js auf meinem VPS?
In diesem Artikel
Node.js brauchst du unter anderem für Discord-Bots, Web-Apps und moderne Tools wie KI-Agenten. Das naheliegende apt install nodejs ist dafür keine gute Idee: Ubuntu und Debian liefern so eine alte Version. Unter Ubuntu 24.04 bekommst du Node.js 18, unter Ubuntu 22.04 sogar Node.js 12, und beide werden vom Node.js-Projekt nicht mehr gepflegt. Viele aktuelle Programme starten damit gar nicht; OpenClaw verlangt zum Beispiel mindestens Node.js 24.16. In dieser Anleitung installierst du die aktuelle LTS-Version auf offiziellem Weg und prüfst danach die Version. Die Schritte gelten für einen Linux-VPS mit Ubuntu oder Debian; auf einem Windows-VPS nimmst du den Installer von nodejs.org.
Welche Version solltest du wählen?
Wähle eine LTS-Version (Long Term Support): Sie bekommt jahrelang Sicherheitsupdates. Seit dem 28. Oktober 2026 ist das Node.js 26, die Version in den Befehlen unten. Node.js 24 wird noch bis zum 30. April 2028 gepflegt; verlangt ein Programm ausdrücklich Version 24, ersetze 26 durch 24. Welche Versionen gerade LTS sind, siehst du auf nodejs.org.
Es gibt zwei offizielle Wege. Entscheide dich für einen: Wenn du beide mischst, ist schnell unklar, welches node eigentlich läuft.
- NodeSource (empfohlen für einen Server): Node.js kommt als normales Paket nach
/usr/bin/node, für alle Benutzer und Dienste, und Updates bekommst du mitapt upgrade. - nvm (Node Version Manager): installiert Node.js pro Benutzer im Home-Verzeichnis. Praktisch, wenn du mehrere Versionen parallel nutzen willst. Diese Methode steht auch auf der Download-Seite von nodejs.org.
Vorbereitung: eine alte Version entfernen
Verbinde dich per SSH mit deinem VPS (siehe per SSH mit dem VPS verbinden). Bist du als root angemeldet, kann das sudo vor den Befehlen einfach stehen bleiben. Prüfe zuerst, ob schon Node.js installiert ist:
node -v
Kommt command not found, mach direkt mit einer der Methoden weiter. Siehst du eine alte Version wie v18.19.1 oder v12.22.9, entferne sie zuerst. Sonst bricht die Installation wegen eines Konflikts mit dem Paket libnode-dev ab:
sudo apt remove -y nodejs npm libnode-dev
sudo apt autoremove -y
Methode 1: NodeSource (empfohlen)
Führe diese Befehle nacheinander aus:
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
Das Skript von NodeSource fügt deren Paketquelle und Signaturschlüssel zu apt hinzu; die letzte Zeile installiert Node.js. npm ist schon dabei, das installierst du nicht separat. Willst du vorher sehen, was das Skript macht, schau es dir vor der vierten Zeile mit less nodesource_setup.sh an.
Methode 2: nvm (pro Benutzer)
Melde dich als der Benutzer an, der Node.js verwenden soll, denn nvm legt alles in dessen Home-Verzeichnis ab. Auf einer frischen Minimalinstallation fehlen manchmal curl und libatomic1 (ohne Letzteres startet Node.js nicht), deshalb installiert die erste Zeile beides:
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
Die dritte Zeile lädt nvm sofort in deine aktuelle Sitzung; beim nächsten Login passiert das automatisch. Die neueste nvm-Versionsnummer (hier v0.41.0) findest du auf GitHub.
Achtung: Ein Node.js aus nvm liegt nur in deinem Home-Verzeichnis. Ein systemd-Dienst oder ein anderer Benutzer findet es nicht von selbst. Soll dein Bot oder deine App als Dienst laufen, ist NodeSource die einfachere Wahl.
Die Version prüfen
node -v
npm -v
Du siehst jetzt zum Beispiel v26.13.0 und 11.20.0. Beginnt die Node-Version mit v26 (oder v24, falls du die gewählt hast), bist du fertig.
Aktualisieren
Bei NodeSource kommen neue Versionen innerhalb derselben Reihe (zum Beispiel von 26.13 auf 26.14) mit sudo apt update && sudo apt upgrade. Auf eine neue Hauptversion wechselst du, indem du das Setup-Skript dieser Version ausführst und danach erneut sudo apt install -y nodejs startest. Bei nvm holt nvm install 26 die neueste 26.x.
Häufige Probleme
trying to overwrite '/usr/include/node/common.gypi': Das alte Node.js von Ubuntu ist noch installiert, zusammen mitlibnode-dev. Entferne es mit den Befehlen unter Vorbereitung und führe danachsudo apt install -y nodejserneut aus.node -vzeigt noch die alte Version: Deine Shell merkt sich den alten Pfad. Tippehash -roder melde dich neu an. Mitwhich -a nodesiehst du, welche Node.js-Installationen es gibt; eine in~/.nvmhat Vorrang vor der von NodeSource.nvm: command not found: Deine aktuelle Sitzung kennt nvm noch nicht. Melde dich neu an oder führe\. "$HOME/.nvm/nvm.sh"aus.error while loading shared libraries: libatomic.so.1: Installiere die fehlende Bibliothek mitsudo apt install -y libatomic1.- Günstiger VPS (OpenVZ): Die offiziellen Node.js-Builds sind für Linux-Kernel 4.18 oder neuer gedacht. Unter OpenVZ teilst du dir den Kernel mit dem Host; prüfe ihn mit
uname -r. Ist er älter, kann Node.js trotzdem laufen, offiziell unterstützt wird das aber nicht. Für anspruchsvolle Node-Apps ist ein KVM-VPS die sicherere Wahl.
Brauchst du Hilfe?
Kommst du nicht weiter? Eröffne ein Ticket über unsere Support-Seite und füge die Ausgabe von node -v und die vollständige Fehlermeldung bei.
Auf eigener Hardware in Hengelo (NL), DDoS-Schutz inklusive, monatlich kündbar.