Variables de Entorno

Volta respeta varias variables de entorno que controlan su comportamiento. Esta página sirve como referencia para todas las variables de entorno disponibles y sus efectos.

Variables de Entorno Principales

VOLTA_HOME

Establece el directorio donde Volta almacena sus datos, incluyendo herramientas descargadas y configuración.

• Por defecto:
  • Unix: $HOME/.volta
  • Windows: %LOCALAPPDATA%\Volta
• Ejemplo: VOLTA_HOME=/opt/volta

VOLTA_LOGLEVEL

Controla la verbosidad de la salida de registro de Volta.

• Valores válidos: error, warn, info, verbose, debug
• Por defecto: info
• Ejemplo: VOLTA_LOGLEVEL=debug volta install node

VOLTA_SKIP_SETUP

Cuando se establece a 1, previene que Volta modifique perfiles de shell durante la instalación.

• Valores válidos: 0, 1
• Por defecto: 0
• Ejemplo: VOLTA_SKIP_SETUP=1 bash -c "$(curl https://get.volta.sh)"

Banderas de Características

VOLTA_FEATURE_PNPM

Habilita soporte de pnpm en Volta.

• Valores válidos: 0, 1
• Por defecto: 0
• Ejemplo: VOLTA_FEATURE_PNPM=1 volta install pnpm

Configuración de Red

VOLTA_NETWORK_TIMEOUT_SECS

Establece el tiempo de espera en segundos para operaciones de red.

• Por defecto: 60
• Ejemplo: VOLTA_NETWORK_TIMEOUT_SECS=120 volta install node

HTTP_PROXY / HTTPS_PROXY

Variables de entorno de proxy estándar usadas por Volta para solicitudes de red.

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

NO_PROXY

Lista separada por comas de hosts que deberían evitar el proxy.

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

Variables de Instalación

VOLTA_LATEST_VERSION

Fuerza al instalador de Volta a usar una versión específica en lugar de la última.

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

VOLTA_TARGET_PROFILE

Especifica qué archivo de perfil de shell debe modificar el instalador.

• Por defecto: Detectado basado en el shell actual
• Ejemplo: VOLTA_TARGET_PROFILE=$HOME/.bashrc

Variables Específicas de Plataforma

VOLTA_MIN_COMPATIBLE_VERSION_UPDATE_CHECK

La versión mínima de Volta para verificación de compatibilidad en notificaciones de actualización.

• Ejemplo: VOLTA_MIN_COMPATIBLE_VERSION_UPDATE_CHECK=1.0.5

Variables Específicas de Windows

Estas variables solo se usan en sistemas Windows:

VOLTA_REDIRECT_STDERR

Cuando se establece a 1, redirige la salida stderr a stdout en Windows.

• Valores válidos: 0, 1
• Por defecto: 0

Uso Avanzado

VOLTA_UNSAFE_DIAGNOSTIC

Usado para depuración; habilita diagnósticos avanzados que pueden ser inestables.

• Valores válidos: Cualquier cadena
• Ejemplo: VOLTA_UNSAFE_DIAGNOSTIC=timing volta install node

VOLTA_STDIN_FILE_PASSTHROUGH

Cuando se establece, Volta usará esta ruta de archivo en lugar de stdin para ejecución de scripts.

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

Configuraciones de Ejemplo

Entorno de Desarrollo

Para una configuración de desarrollo con registro verboso:

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

Pipeline CI/CD

Para entornos de integración continua:

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

Red Corporativa

Para entornos con servidores 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