Umgebungsvariablen

Volta respektiert mehrere Umgebungsvariablen, die sein Verhalten steuern. Diese Seite dient als Referenz für alle verfügbaren Umgebungsvariablen und ihre Auswirkungen.

Kern-Umgebungsvariablen

VOLTA_HOME

Legt das Verzeichnis fest, in dem Volta seine Daten speichert, einschließlich heruntergeladener Tools und Konfiguration.

• Standard:
  • Unix: $HOME/.volta
  • Windows: %LOCALAPPDATA%\Volta
• Beispiel: VOLTA_HOME=/opt/volta

VOLTA_LOGLEVEL

Steuert die Ausführlichkeit von Voltas Logging-Ausgabe.

• Gültige Werte: error, warn, info, verbose, debug
• Standard: info
• Beispiel: VOLTA_LOGLEVEL=debug volta install node

VOLTA_SKIP_SETUP

Wenn auf 1 gesetzt, verhindert es, dass Volta Shell-Profile während der Installation modifiziert.

• Gültige Werte: 0, 1
• Standard: 0
• Beispiel: VOLTA_SKIP_SETUP=1 bash -c "$(curl https://get.volta.sh)"

Feature Flags

VOLTA_FEATURE_PNPM

Aktiviert pnpm-Unterstützung in Volta.

• Gültige Werte: 0, 1
• Standard: 0
• Beispiel: VOLTA_FEATURE_PNPM=1 volta install pnpm

Netzwerkkonfiguration

VOLTA_NETWORK_TIMEOUT_SECS

Legt das Timeout in Sekunden für Netzwerkoperationen fest.

• Standard: 60
• Beispiel: VOLTA_NETWORK_TIMEOUT_SECS=120 volta install node

HTTP_PROXY / HTTPS_PROXY

Standard-Proxy-Umgebungsvariablen, die von Volta für Netzwerkanfragen verwendet werden.

• Beispiel:
  • HTTP_PROXY=http://proxy.example.com:8080
  • HTTPS_PROXY=http://proxy.example.com:8080

NO_PROXY

Kommagetrennte Liste von Hosts, die den Proxy umgehen sollen.

• Beispiel: NO_PROXY=localhost,127.0.0.1,.example.com

Installationsvariablen

VOLTA_LATEST_VERSION

Zwingt den Volta-Installer, eine bestimmte Version anstelle der neuesten zu verwenden.

• Beispiel: VOLTA_LATEST_VERSION=1.0.5 bash -c "$(curl https://get.volta.sh)"

VOLTA_TARGET_PROFILE

Spezifiziert, welche Shell-Profil-Datei der Installer modifizieren soll.

• Standard: Basierend auf der aktuellen Shell erkannt
• Beispiel: VOLTA_TARGET_PROFILE=$HOME/.bashrc

Plattformspezifische Variablen

VOLTA_MIN_COMPATIBLE_VERSION_UPDATE_CHECK

Die minimale Volta-Version für Kompatibilitätsprüfung in Update-Benachrichtigungen.

• Beispiel: VOLTA_MIN_COMPATIBLE_VERSION_UPDATE_CHECK=1.0.5

Windows-spezifische Variablen

Diese Variablen werden nur auf Windows-Systemen verwendet:

VOLTA_REDIRECT_STDERR

Wenn auf 1 gesetzt, leitet stderr-Ausgabe auf Windows an stdout weiter.

• Gültige Werte: 0, 1
• Standard: 0

Erweiterte Nutzung

VOLTA_UNSAFE_DIAGNOSTIC

Für Debugging verwendet; aktiviert erweiterte Diagnosen, die möglicherweise instabil sind.

• Gültige Werte: Beliebiger String
• Beispiel: VOLTA_UNSAFE_DIAGNOSTIC=timing volta install node

VOLTA_STDIN_FILE_PASSTHROUGH

Wenn gesetzt, verwendet Volta diesen Dateipfad anstelle von stdin für Skriptausführung.

• Beispiel: VOLTA_STDIN_FILE_PASSTHROUGH=/tmp/script.js volta run node

Beispielkonfigurationen

Entwicklungsumgebung

Für eine Entwicklungseinrichtung mit ausführlichem Logging:

export VOLTA_HOME=$HOME/.volta
export VOLTA_LOGLEVEL=verbose
export PATH=$VOLTA_HOME/bin:$PATH

CI/CD-Pipeline

Für kontinuierliche Integrationsumgebungen:

export VOLTA_HOME=$HOME/.volta
export VOLTA_LOGLEVEL=error
export VOLTA_NETWORK_TIMEOUT_SECS=300
export PATH=$VOLTA_HOME/bin:$PATH

Unternehmensnetzwerk

Für Umgebungen mit Proxy-Servern:

export VOLTA_HOME=$HOME/.volta
export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
export NO_PROXY=localhost,127.0.0.1,.internal.example.com
export PATH=$VOLTA_HOME/bin:$PATH