Variáveis de Ambiente

O Volta respeita várias variáveis de ambiente que controlam seu comportamento. Esta página serve como referência para todas as variáveis disponíveis e seus efeitos.

Variáveis de Ambiente Principais

`VOLTA_HOME`

Define o diretório onde o Volta armazena seus dados, incluindo ferramentas baixadas e configurações.

Valor padrão:
- Unix: $HOME/.volta
- Windows: %LOCALAPPDATA%\Volta
Exemplo: VOLTA_HOME=/opt/volta

`VOLTA_LOGLEVEL`

Controla o nível de detalhamento dos logs do Volta.

Valores válidos: error, warn, info, verbose, debug
Valor padrão: info
Exemplo: VOLTA_LOGLEVEL=debug volta install node

`VOLTA_SKIP_SETUP`

Quando definido como 1, impede que o Volta modifique scripts de configuração do shell durante a instalação.

Valores válidos: 0, 1
Valor padrão: 0
Exemplo: VOLTA_SKIP_SETUP=1 bash -c "$(curl https://get.volta.sh)"

Flags de Funcionalidade

`VOLTA_FEATURE_PNPM`

Habilita o suporte ao pnpm no Volta.

Valores válidos: 0, 1
Valor padrão: 0
Exemplo: VOLTA_FEATURE_PNPM=1 volta install pnpm

Configuração de Rede

`VOLTA_NETWORK_TIMEOUT_SECS`

Define o tempo limite (em segundos) para operações de rede.

Valor padrão: 60
Exemplo: VOLTA_NETWORK_TIMEOUT_SECS=120 volta install node

`HTTP_PROXY` / `HTTPS_PROXY`

Variáveis de ambiente padrão para proxy de rede usadas pelo Volta.

Exemplo:
- HTTP_PROXY=http://proxy.example.com:8080
- HTTPS_PROXY=http://proxy.example.com:8080

`NO_PROXY`

Lista separada por vírgulas de hosts que devem ignorar o proxy.

Exemplo: NO_PROXY=localhost,127.0.0.1,.example.com

Variáveis de Instalação

`VOLTA_LATEST_VERSION`

Força o instalador do Volta a usar uma versão específica em vez da mais recente.

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

`VOLTA_TARGET_PROFILE`

Especifica qual script de configuração de shell deve ser modificado pelo instalador.

Valor padrão: Detectado automaticamente com base no shell atual
Exemplo: VOLTA_TARGET_PROFILE=$HOME/.bashrc

Variáveis Específicas de Plataforma

`VOLTA_MIN_COMPATIBLE_VERSION_UPDATE_CHECK`

Define a versão mínima do Volta para verificação de compatibilidade em notificações de atualização.

Exemplo: VOLTA_MIN_COMPATIBLE_VERSION_UPDATE_CHECK=1.0.5

Variáveis Específicas do Windows

Estas variáveis só são usadas no Windows:

`VOLTA_REDIRECT_STDERR`

Quando definida como 1, redireciona a saída stderr para stdout no Windows.

Valores válidos: 0, 1
Valor padrão: 0

Uso Avançado

`VOLTA_UNSAFE_DIAGNOSTIC`

Para depuração; ativa diagnósticos avançados potencialmente instáveis.

Valores válidos: qualquer string
Exemplo: VOLTA_UNSAFE_DIAGNOSTIC=timing volta install node

`VOLTA_STDIN_FILE_PASSTHROUGH`

Quando definida, o Volta usará o caminho do arquivo especificado em vez de stdin para execução de scripts.

Exemplo: VOLTA_STDIN_FILE_PASSTHROUGH=/tmp/script.js volta run node

Exemplos de Configuração

Ambiente de Desenvolvimento

Para configuração de desenvolvimento com logs detalhados:

bash

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

Pipeline CI/CD

Para ambientes de integração contínua:

bash

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

Rede Corporativa

Para ambientes com servidores proxy:

bash

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

Variáveis de Ambiente ​