Variables d'environnement

Volta respecte plusieurs variables d'environnement qui contrôlent son comportement. Cette page sert de référence pour toutes les variables d'environnement disponibles et leurs effets.

Variables d'environnement principales

VOLTA_HOME

Définit le répertoire où Volta stocke ses données, y compris les outils téléchargés et la configuration.

• Valeur par défaut :
  • Unix : $HOME/.volta
  • Windows : %LOCALAPPDATA%\Volta
• Exemple : VOLTA_HOME=/opt/volta

VOLTA_LOGLEVEL

Contrôle le niveau de détail de la sortie de log de Volta.

• Valeurs valides : error, warn, info, verbose, debug
• Valeur par défaut : info
• Exemple : VOLTA_LOGLEVEL=debug volta install node

VOLTA_SKIP_SETUP

Quand défini à 1, empêche Volta de modifier les fichiers de configuration du shell pendant l'installation.

• Valeurs valides : 0, 1
• Valeur par défaut : 0
• Exemple : VOLTA_SKIP_SETUP=1 bash -c "$(curl https://get.volta.sh)"

Drapeaux de fonctionnalités

VOLTA_FEATURE_PNPM

Active le support de pnpm dans Volta.

• Valeurs valides : 0, 1
• Valeur par défaut : 0
• Exemple : VOLTA_FEATURE_PNPM=1 volta install pnpm

Configuration réseau

VOLTA_NETWORK_TIMEOUT_SECS

Définit le délai d'attente pour les opérations réseau en secondes.

• Valeur par défaut : 60
• Exemple : VOLTA_NETWORK_TIMEOUT_SECS=120 volta install node

HTTP_PROXY / HTTPS_PROXY

Variables d'environnement de proxy standard utilisées par Volta pour les requêtes réseau.

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

NO_PROXY

Liste séparée par des virgules des hôtes qui doivent contourner le proxy.

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

Variables d'installation

VOLTA_LATEST_VERSION

Force l'installateur Volta à utiliser une version spécifique au lieu de la dernière.

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

VOLTA_TARGET_PROFILE

Spécifie quel fichier de configuration shell l'installateur devrait modifier.

• Valeur par défaut : Auto-détecté basé sur le shell actuel
• Exemple : VOLTA_TARGET_PROFILE=$HOME/.bashrc

Variables spécifiques à la plateforme

VOLTA_MIN_COMPATIBLE_VERSION_UPDATE_CHECK

Version minimum de Volta pour les vérifications de compatibilité dans les notifications de mise à jour.

• Exemple : VOLTA_MIN_COMPATIBLE_VERSION_UPDATE_CHECK=1.0.5

Variables spécifiques à Windows

Ces variables sont utilisées uniquement sur les systèmes Windows :

VOLTA_REDIRECT_STDERR

Quand défini à 1, redirige la sortie stderr vers stdout sur Windows.

• Valeurs valides : 0, 1
• Valeur par défaut : 0

Usage avancé

VOLTA_UNSAFE_DIAGNOSTIC

Utilisé pour le débogage ; active des diagnostics avancés qui peuvent ne pas être stables.

• Valeurs valides : Toute chaîne
• Exemple : VOLTA_UNSAFE_DIAGNOSTIC=timing volta install node

VOLTA_STDIN_FILE_PASSTHROUGH

Quand défini, Volta utilisera ce chemin de fichier au lieu de stdin pour l'exécution de scripts.

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

Exemples de configuration

Environnement de développement

Pour une configuration de développement avec logs détaillés :

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

Pipeline CI/CD

Pour un environnement d'intégration continue :

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

Réseau d'entreprise

Pour des environnements avec serveurs proxy :

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