Tutorials

[Gelöst] "volta: command not found" unter Linux – Schritt-für-Schritt-Anleitung

Melden

Wenn du das JavaScript-Tool-Manager-Tool Volta unter Linux installiert hast, aber beim Ausführen des Befehls die Fehlermeldung bash: volta: command not found (oder zsh: command not found: volta) erhältst, liegt das fast immer daran, dass der Installationspfad von Volta nicht in deiner Umgebungsvariablen (PATH) hinterlegt ist.

In diesem Tutorial erfährst du, wie du das Problem schnell und dauerhaft behebst.

Ursache des Problems

Das Installationsskript von Volta legt die Binärdateien standardmäßig im versteckten Verzeichnis ~/.volta/bin ab. Wenn deine Shell (Bash, Zsh etc.) nicht weiß, dass sie dort nach Programmen suchen soll, schlägt der Aufruf fehl.

Lösung 1: Volta manuell zur PATH-Variable hinzufügen (Empfohlen)

Finde zunächst heraus, welche Shell du nutzt (in der Regel Bash oder Zsh), und trage den Pfad manuell in deine Konfigurationsdatei ein.

Für Bash-Nutzer (Standard bei vielen Linux-Distributionen wie Ubuntu, Debian):

  1. Öffne die Konfigurationsdatei ~/.bashrc mit einem Editor (z. B. nano):
    nano ~/.bashrc
  2. Scrolle ganz nach unten und füge folgende Zeilen ein:
    export VOLTA_HOME="$HOME/.volta"
export PATH="$VOLTA_HOME/bin:$PATH"
  3. Speichere die Datei mit Strg + O, bestätige mit Enter und schließe den Editor mit Strg + X.
  4. Lade die Datei neu, damit die Änderungen wirksam werden:
    source ~/.bashrc

Für Zsh-Nutzer:

  1. Öffne die Konfigurationsdatei ~/.zshrc:
    nano ~/.zshrc
  2. Füge dieselben Zeilen am Ende ein:
    export VOLTA_HOME="$HOME/.volta"
export PATH="$VOLTA_HOME/bin:$PATH"
  3. Speichere die Datei und lade sie neu:
    source ~/.zshrc

Lösung 2: Volta sauber neu installieren

Falls das Verzeichnis ~/.volta auf deinem System gar nicht existiert, ist die vorherige Installation möglicherweise fehlgeschlagen. Installiere Volta in diesem Fall einfach erneut über das offizielle Skript.

  1. Führe den offiziellen Installer aus:
    curl https://get.volta.sh | bash
  2. Achte auf die Ausgabe im Terminal. Der Installer versucht normalerweise, deine Profildateien automatisch anzupassen.
  3. Wichtig: Starte danach dein Terminal komplett neu oder lade dein Profil mit source ~/.bashrc bzw. source ~/.zshrc neu.

Testen, ob es funktioniert hat

Überprüfe nun, ob Volta erkannt wird, indem du die Version abfragst:

volta --version

Wenn dir nun eine Versionsnummer angezeigt wird, ist das Problem gelöst! Du kannst nun Node.js, npm oder Yarn über Volta installieren:

volta install node
0