Wie installiere ich Node.js auf einem Ubuntu- oder Debian-VPS?
Eine aktuelle LTS-Version von Node.js mit NodeSource oder nvm auf Ubuntu 24.04 und Debian 12 installieren, die Anwendung mit PM2 online halten und beim
Das Paket nodejs aus den offiziellen Paketquellen installiert unter Ubuntu 24.04 wie unter Debian 12 Node.js 18, eine Version ohne Korrekturen seit April 2025. Für eine Anwendung oder einen Bot im Produktivbetrieb installieren Sie eine LTS-Version: Node.js 26 ist am 17. November 2026 die aktive LTS, Node.js 24 wird weiter gepflegt. Die Befehle dieser Anleitung wurden auf Ubuntu 24.04 und Debian 12 getestet.
Schritt-für-Schritt-Anleitung
-
Wählen Sie die Methode
NodeSource fügt eine APT-Paketquelle hinzu: eine Version für das ganze System, aktualisiert mit apt upgrade. nvm installiert Node.js im Ordner eines Benutzers und erlaubt mehrere Versionen nebeneinander. Für einen einzelnen Dienst genügt NodeSource; für mehrere Projekte mit unterschiedlichen Versionen nehmen Sie nvm.
-
Mit NodeSource installieren
Laden Sie als root das Skript setup_26.x herunter, lesen Sie es bei Bedarf, führen Sie es mit bash aus und dann apt install -y nodejs. Das Paket enthält npm bereits: Installieren Sie nicht zusätzlich das Paket npm der Distribution.
-
Oder mit nvm installieren
Melden Sie sich als der Benutzer an, der die Anwendung ausführen wird, installieren Sie zuerst curl und libatomic1 und starten Sie dann das Installationsskript von nvm v0.41.0. Laden Sie die Shell mit source ~/.bashrc neu; nvm install --lts installiert dann die neueste LTS und macht sie zum Standard.
-
Versionen prüfen
node -v sollte v26 mit der Patch-Nummer anzeigen und npm -v eine Version 11. Zeigt node -v noch v18, hat das alte Paket der Distribution Vorrang: which node zeigt das verwendete Programm.
-
Die Anwendung mit PM2 starten
Installieren Sie PM2 mit npm install -g pm2, wechseln Sie in den Projektordner und führen Sie pm2 start index.js --name app aus. PM2 startet den Prozess neu, wenn er abstürzt; pm2 logs app zeigt seine Ausgabe, pm2 restart app startet ihn nach einem Code-Update neu.
-
Beim Start des VPS neu starten
pm2 startup legt einen systemd-Dienst an; bei einem Benutzer ohne root-Rechte gibt es einen Befehl sudo env PATH= aus, den Sie unverändert kopieren. Führen Sie danach pm2 save aus, um die Liste der Prozesse zu speichern, die PM2 nach einem Neustart wiederherstellt.
Node.js 26 LTS mit 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 mit nvm (Benutzer der Anwendung)
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: starten, verfolgen und beim Booten neu starten
npm install -g pm2
cd ~/app
pm2 start index.js --name app
pm2 list
pm2 logs app --lines 50
pm2 startup
pm2 save
Bevor Sie beginnen
Sie brauchen SSH-Zugang zum VPS und einen eigenen Benutzer für die Anwendung statt root: adduser app legt ihn an. Wurde apt install nodejs bereits ausgeführt, entfernen Sie diese alte Version mit apt remove nodejs, bevor Sie zu NodeSource oder nvm wechseln, damit keine zwei Programme konkurrieren.
- Eine einfache Node.js-Anwendung oder ein Discord-Bot läuft mit weniger als 200 MB RAM; die Installation der Abhängigkeiten mit npm braucht für einige Sekunden mehr.
- Das Feld engines in package.json oder eine Datei .nvmrc gibt die vom Projekt erwartete Version an.
Mehrere Versionen mit nvm
nvm install 24 fügt Node.js 24 neben 26 hinzu, nvm use 24 wechselt die aktuelle Shell, und nvm alias default 26 legt die Version für neue Shells fest. In einem Ordner mit einer Datei .nvmrc, die 24 enthält, lädt nvm use ohne Argument die richtige Version. Mit nvm installierte Versionen liegen in ~/.nvm: Sie gibt es nur für diesen Benutzer, und ein systemd-Dienst oder ein Cronjob muss den vollständigen Pfad des Programms aufrufen oder PM2 verwenden.
Die Anwendung im Internet erreichbar machen
Ein Discord-Bot braucht keinen eingehenden Port: Er verbindet sich selbst mit Discord. Eine API oder eine Website lauscht dagegen auf einem Port wie 3000. Am saubersten lassen Sie sie auf 127.0.0.1 und setzen Nginx mit einem Let’s-Encrypt-Zertifikat davor; andernfalls öffnen Sie den Port in UFW und in der Panel-Firewall.
Häufige Fehler und Lösungen
Die meisten Fehler entstehen durch eine andere als die erwartete Node.js-Version oder durch eine Shell, die nvm nicht geladen hat.
- nvm: command not found direkt nach der Installation: Die Shell hat ~/.bashrc noch nicht gelesen. Führen Sie source ~/.bashrc aus oder öffnen Sie eine neue SSH-Sitzung.
- node: error while loading shared libraries: libatomic.so.1 mit nvm: Auf einer Minimalinstallation fehlt die Bibliothek. apt install libatomic1 behebt den Fehler, ohne Node.js neu zu installieren.
- npm ERR! code EACCES bei npm install -g: Der globale Ordner gehört root. Mit NodeSource installieren Sie globale Werkzeuge als root; mit nvm führen Sie den Befehl ohne sudo aus.
- SyntaxError: Unexpected token oder ERR_REQUIRE_ESM beim Start: Das Projekt erwartet eine neuere Version. Vergleichen Sie node -v mit dem Feld engines in package.json.
- Die Anwendung kommt nach einem Neustart des VPS nicht zurück: pm2 save wurde nach dem letzten pm2 start nicht ausgeführt, oder der von pm2 startup ausgegebene Befehl wurde nicht ausgeführt.
VPS oder Bot-Hosting?
Für einen einzelnen Discord-Bot in Node.js erspart Ihnen das Bot-Hosting von ACLClouds diese ganze Einrichtung: Sie laden den Code hoch, das Panel installiert die Abhängigkeiten, betreibt den Bot rund um die Uhr und startet ihn bei einem Absturz neu. Der kostenlose Tarif (315 MB RAM) unterstützt Node.js und Python; der Starter-Tarif kostet 2,99 € pro Monat oder 2,39 € pro Monat mit einer Laufzeit von einem Jahr (Preise vom 17. November 2026).
Ein VPS lohnt sich für mehrere Anwendungen, eine API mit Datenbank oder wenn Sie volle Kontrolle brauchen. Der VPS Mini (2 vCPU, 8 GB RAM, 40 GB Speicher) kostet 4,99 € pro Monat ohne Mindestlaufzeit oder 3,99 € pro Monat mit einer Laufzeit von einem Jahr, mit einem Netzwerk von bis zu 1 Gbit/s.
Schnellüberprüfung
- node -v zeigt eine LTS-Version (v26 oder v24).
- pm2 list zeigt die Anwendung als online.
- Die Anwendung startet nach einem Neustart des VPS von selbst.
- Die Anwendung läuft nicht als root.
Häufig gestellte Fragen
Warum Node.js nicht mit apt install nodejs installieren?
Die Paketquellen von Ubuntu 24.04 und Debian 12 liefern Node.js 18, dessen Support im April 2025 endete, und viele aktuelle Bibliotheken wie Vite 8 oder ESLint 10 verlangen eine neuere Version. NodeSource oder nvm installieren eine gepflegte LTS.
NodeSource oder nvm: Was soll ich wählen?
NodeSource passt zu einem Server mit einer einzigen Anwendung: Node.js steht allen Benutzern zur Verfügung und wird mit dem restlichen System aktualisiert. nvm passt, wenn mehrere Projekte unterschiedliche Versionen brauchen oder Sie eine neue Version testen wollen, ohne die produktive anzutasten.
Wie aktualisiere ich Node.js auf eine neue LTS?
Mit NodeSource spielt apt upgrade die Korrekturen derselben Hauptversion ein; für eine neue Hauptversion starten Sie das Skript der neuen Version erneut und dann apt install nodejs. Mit nvm installiert nvm install --lts --reinstall-packages-from=current die neue LTS und übernimmt die globalen Pakete, auch PM2. Starten Sie danach die Anwendung neu und prüfen Sie ihre Protokolle.
PM2 oder systemd, um die Anwendung online zu halten?
Beide starten den Prozess nach einem Absturz und beim Booten des VPS neu. PM2 ist für mehrere Node.js-Anwendungen einfacher, mit pm2 list, pm2 logs und dem Cluster-Modus; systemd braucht kein zusätzliches Werkzeug und passt zu einem einzelnen Dienst. Kombinieren Sie nicht beide für dieselbe Anwendung.