Node.js auf Ubuntu 24.04 aktualisieren – NVM, APT & Binär

Node.js ist eine kostenlose, plattformübergreifende Laufzeitumgebung, die es ermöglicht, JavaScript serverseitig auszuführen. Mit der Installation auf Ubuntu erhält man Zugriff auf das leistungsstarke Ökosystem, inklusive des Node Package Managers (npm), dem offiziellen Register für JavaScript-Pakete. Node.js wird sowohl im Frontend- als auch im Backend-Bereich genutzt und profitiert von einer aktiven Entwickler-Community mit umfangreicher Dokumentation – ein unverzichtbares Werkzeug moderner Anwendungsentwicklung.

In dieser Anleitung wird gezeigt, wie man Node.js unter Ubuntu 24.04 mit drei Methoden aktualisiert: NVM (Node Version Manager), offiziellen Binärpaketen und dem APT-Paketmanager. Außerdem wird erklärt, wie man die installierte Version vor und nach dem Upgrade überprüft.

Voraussetzungen

Vor dem Start sollten folgende Punkte erfüllt sein:

• Eine Ubuntu 24.04 Installation mit bereits vorhandenem Node.js.
• SSH-Zugriff auf den Server.
• Ein Benutzerkonto ohne Root-Rechte, aber mit sudo-Berechtigungen.
• Zugriff auf die NodeSource-Versionsübersicht, um die unterstützten Node.js-Versionen für Ubuntu 24.04 zu prüfen.

Installierte Node.js-Version prüfen

Vor dem Upgrade sollte die aktuell installierte Version geprüft werden. So lässt sich sicherstellen, ob das Update erfolgreich durchgeführt wurde.

$ node -v

Ausgabe:

v18.19.1

Falls ein „command not found“-Fehler erscheint, ist Node.js nicht installiert. In diesem Fall kann eine der unten beschriebenen Methoden verwendet werden, um die gewünschte Version zu installieren.

Hinweis: Es ist sinnvoll, die eigene Version mit der aktuellen LTS-Version auf der offiziellen Node.js-Website zu vergleichen, um zu entscheiden, ob ein Update notwendig ist.

Node Version Manager (NVM) installieren

Der Node Version Manager (NVM) ist ein Kommandozeilen-Tool, mit dem sich mehrere Node.js-Versionen auf einem System installieren, verwalten und wechseln lassen. Er erleichtert das Upgrade und ermöglicht es, eine Standardversion für die Shell-Sitzungen festzulegen. Befolge dazu die folgenden Schritte:

Nur für die NVM-Methode: Diesen Abschnitt brauchst du nur, wenn du Node.js über NVM aktualisieren willst. Für Binärpakete oder APT springst du direkt zu Node.js unter Ubuntu 24.04 aktualisieren – NVM zusätzlich zu installieren, führt dort zu Konflikten.

Lade das Installationsskript für NVM herunter und führe es aus:

$ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.2/install.sh | bash

Wichtig: NVM arbeitet ausschließlich im eigenen Benutzerkonto unter ~/.nvm. Führe das Installationsskript, nvm-Befehle und npm install -g unter NVM daher nie mit sudo oder in einer Root-Shell aus. Sonst entstehen in ~/.nvm Verzeichnisse, die root gehören, und spätere Befehle wie nvm alias default scheitern an fehlenden Schreibrechten. Ist das bereits passiert, gibst du die Dateien so an deinen Benutzer zurück:

$ sudo chown -R "$USER":"$USER" ~/.nvm

Lade anschließend die Shell-Konfiguration neu, um NVM zu aktivieren:

$ source ~/.bashrc

Wenn Zsh verwendet wird, lautet der Befehl stattdessen:

$ source ~/.zshrc

Prüfe anschließend, ob NVM korrekt installiert wurde:

$ nvm --version

Ausgabe:

0.40.2

Node.js unter Ubuntu 24.04 aktualisieren

Das Upgrade von Node.js auf Ubuntu 24.04 kann über NVM, Binärpakete oder den APT-Paketmanager erfolgen. Wähle die Methode, die am besten zur eigenen Umgebung passt.

Warnung: Es sollte immer nur eine Methode verwendet werden. Eine Mischung aus NVM, Binärinstallation und APT kann zu Konflikten führen. Falls die Methode gewechselt wird, müssen zuvor alle bestehenden Node.js-Versionen vollständig entfernt werden.

Wechsel von NVM auf Binärpakete oder APT: Solange NVM beim Start der Shell geladen wird, setzt es seine eigene Node.js-Version an den Anfang des PATH. Eine über APT installierte Version unter /usr/bin bleibt dann verdeckt, und node -v zeigt weiterhin die NVM-Version. Entferne NVM deshalb vor dem Wechsel:

$ nvm unload

$ rm -rf "$NVM_DIR"

Lösche anschließend die NVM-Zeilen aus ~/.bashrc bzw. ~/.zshrc (export NVM_DIR=… und die beiden Zeilen, die nvm.sh und bash_completion laden) und öffne eine neue Shell.

NVM ist die bevorzugte Option, da sich damit sowohl die aktuelle LTS-Version als auch spezifische Versionen installieren lassen. Das ist besonders hilfreich in Entwicklungsumgebungen, die Flexibilität benötigen.

Neueste LTS-Version mit NVM installieren

Die Long-Term-Support-Version (LTS) ist die stabilste und sicherste Variante und wird für den produktiven Einsatz empfohlen. So wird die aktuelle LTS-Version installiert und als Standard festgelegt:

Alle verfügbaren Node.js-Versionen auflisten:

$ nvm list-remote

Ausgabe:

...

v20.12.2 (LTS: Hydrogen)

v22.14.0 (LTS: Iron)

v23.0.0

Die neueste LTS-Version installieren:

$ nvm install --lts

Ausgabe:

Installing latest LTS version.

Downloading and installing node v22.14.0...

Now using node v22.14.0 (npm v10.6.0)

Die installierte Version als Standard für alle Sitzungen festlegen:

$ nvm alias default node

Ausgabe:

default -> node (-> v22.14.0)

Für produktive Umgebungen sollte grundsätzlich eine LTS-Version verwendet werden, um Stabilität und langfristige Updates sicherzustellen.

Eine bestimmte Version mit NVM installieren

Wenn dein Projekt von einer bestimmten Node.js-Version abhängt, kannst du diese gezielt installieren.

Liste die verfügbaren Versionen auf:

$ nvm list-remote

Ausgabe:

...

v18.19.1 (LTS: Hydrogen)

v20.12.2 (LTS: Iron)

v22.1.0

Installiere eine bestimmte Version, indem du <version> mit der gewünschten Versionsnummer ersetzt (z. B. 20.12.2):

$ nvm install <version>

Lege die installierte Version als Standard fest:

$ nvm alias default <version>

Hinweis: Beim Wechsel der Node.js-Versionen werden global installierte npm-Pakete aus der alten Version nicht übernommen. Diese müssen mit npm install -g <package> erneut installiert werden – ebenfalls ohne sudo.

Node.js mit Binärpaketen aktualisieren

Die offizielle Node.js-Website stellt vorkompilierte Binärdateien für Linux-Systeme bereit. Diese Methode ist sinnvoll, wenn eine Version benötigt wird, die über APT oder NVM nicht verfügbar ist.

Lade das Node.js-Binärpaket herunter, wobei <version> durch die gewünschte Versionsnummer ersetzt wird. Alle Versionen findest du auf der offiziellen Node.js-Downloadseite:

$ wget https://nodejs.org/dist/v<version>/node-v<version>-linux-x64.tar.xz

Entpacke das Archiv nach /usr/local/, um Node.js systemweit zu installieren:

$ sudo tar -C /usr/local --strip-components 1 -xJf node-v<version>-linux-x64.tar.xz

Füge /usr/local/bin am Anfang deiner PATH-Variable hinzu, damit das System die neue Version bevorzugt:

$ export PATH=/usr/local/bin:$PATH

Mache die PATH-Anpassung dauerhaft, indem du sie in deine Shell-Konfigurationsdatei einfügst:

$ echo 'export PATH=/usr/local/bin:$PATH' >> ~/.bashrc

Lade die Konfiguration neu, um die Änderungen zu übernehmen:

$ source ~/.bashrc

Wenn du Zsh verwendest, ersetze in den letzten beiden Schritten ~/.bashrc durch ~/.zshrc.

Node.js mit APT aktualisieren

APT ist der Standard-Paketmanager von Ubuntu. Diese Methode installiert oder aktualisiert Node.js durch die Einbindung des offiziellen NodeSource-Repositories. Sie eignet sich besonders für systemweit verwaltete Umgebungen oder automatisierte Deployments.

Lade das NodeSource-Setup-Skript herunter. Ersetze <version> durch die Hauptversionsnummer mit .x (z. B. 20.x oder 22.x). Unterstützte Versionen findest du auf der NodeSource-Distributionsseite:

$ curl -fsSL https://deb.nodesource.com/setup_<version> -o nodesource_setup.sh

Führe das Skript mit Root-Rechten aus. Es bindet nur den Signaturschlüssel und die Paketquelle von NodeSource ein; Node.js selbst installierst du in den nächsten Schritten. Wenn du vorher prüfen willst, was das Skript tut, öffne es mit less nodesource_setup.sh.

$ sudo bash nodesource_setup.sh

Hinweis: Geht der Server über einen Proxy ins Internet, verwende sudo -E bash nodesource_setup.sh, damit die Proxy-Variablen erhalten bleiben. Ohne Proxy ist -E nicht nötig – es gibt deine gesamte Benutzerumgebung an root weiter.

Aktualisiere den Paketindex:

$ sudo apt update

Installiere Node.js:

$ sudo apt install -y nodejs

Überprüfe, ob npm zusammen mit Node.js installiert wurde:

$ npm -v

Ausgabe:

10.5.0

Das Node.js-Paket von NodeSource enthält npm standardmäßig, sodass keine separate Installation erforderlich ist.

Installierte Node.js-Version überprüfen

Nach dem Upgrade prüft man, ob die richtige Node.js- und npm-Version aktiv ist. So wird sichergestellt, dass die Installation erfolgreich war und das System einsatzbereit ist.

Aktive Node.js-Version prüfen:

$ node -v

Ausgabe:

v22.16.0

npm-Version überprüfen:

$ npm -v

Ausgabe:

10.9.2

Wenn die ausgegebenen Versionen mit den installierten übereinstimmen, war das Upgrade erfolgreich und die Umgebung ist korrekt eingerichtet.

Zeigt node -v nach einem Wechsel auf APT oder Binärpakete noch die alte Version, ist vermutlich NVM weiterhin aktiv. Mit which node siehst du, welche Installation die Shell gerade verwendet: /usr/bin/node (APT), /usr/local/bin/node (Binärpaket) oder ein Pfad unter ~/.nvm (NVM).

Fazit

In diesem Tutorial hast du Node.js unter Ubuntu 24.04 mit einer von drei Methoden aktualisiert: NVM, Binärpakete oder den APT-Paketmanager. Anschließend wurde die Aktualisierung durch die Prüfung der aktiven Node.js- und npm-Versionen bestätigt. Abhängig von deinem Workflow bietet jede Methode Vorteile – sei es Flexibilität in der Entwicklung, manuelle Kontrolle oder automatisierte Systembereitstellung. Für weiterführende Konfigurationen empfiehlt sich die offizielle Node.js-Dokumentation.