Começando Rápido

Instalando o Volta

Instalação Unix

Na maioria dos sistemas Unix (incluindo macOS), você pode instalar o Volta com um comando:

curl https://get.volta.sh | bash

Para bash, zsh e fish, este instalador atualizará automaticamente seus scripts de inicialização do console. Se você quiser impedir modificações nos scripts de inicialização do console, veja Pular Configuração do Volta. Para configurar manualmente seu shell para usar o Volta, edite seu script de inicialização do console:

• Defina a variável VOLTA_HOME como $HOME/.volta
• Adicione $VOLTA_HOME/bin ao início da sua variável PATH

Instalação Windows

Para Windows, é recomendado usar o winget para instalar o Volta:

winget install Volta.Volta

Alternativamente, você pode baixar o instalador diretamente e executá-lo manualmente para instalar o Volta.

Subsistema Linux do Windows

Se você estiver usando o Volta no Subsistema Linux do Windows, siga o guia de instalação Unix acima.

Instalação Manual

Se você quiser instalar o Volta manualmente, pode baixar o pacote apropriado para seu sistema operacional da tabela abaixo:

Plataforma	Pacote e Instruções de Instalação
Windows x86_64	volta-2.0.2-windows-x86_64.msi Clique duas vezes no arquivo MSI e siga o assistente de instalação. O instalador adicionará automaticamente o Volta ao seu PATH.
Windows ARM64	volta-2.0.2-windows-arm64.msi Clique duas vezes no arquivo MSI e siga o assistente de instalação. O instalador adicionará automaticamente o Volta ao seu PATH.
Windows x86_64 (ZIP)	volta-2.0.2-windows.zip Extraia o arquivo ZIP para um local de sua escolha. Adicione o diretório extraído à sua variável de ambiente PATH.
Windows ARM64 (ZIP)	volta-2.0.2-windows-arm64.zip Extraia o arquivo ZIP para um local de sua escolha. Adicione o diretório extraído à sua variável de ambiente PATH.
macOS x86_64/ARM64	volta-2.0.2-macos.tar.gz Extraia o tarball e execute o script de instalação incluído: tar xzf volta-2.0.2-macos.tar.gz && ./volta-2.0.2-macos/install.sh
Linux x86_64	volta-2.0.2-linux.tar.gz Extraia o tarball e execute o script de instalação incluído: tar xzf volta-2.0.2-linux.tar.gz && ./volta-2.0.2-linux/install.sh
Linux ARM	volta-2.0.2-linux-arm.tar.gz Extraia o tarball e execute o script de instalação incluído: tar xzf volta-2.0.2-linux-arm.tar.gz && ./volta-2.0.2-linux-arm/install.sh

Passos de Instalação Manual no Windows

1. Baixe o instalador MSI apropriado para sua arquitetura de sistema (x86_64 ou ARM64)
2. Clique duas vezes no arquivo baixado para executar o instalador
3. Siga as instruções do assistente de instalação
4. O instalador adicionará automaticamente o Volta ao PATH do sistema
5. Abra uma nova janela de Prompt de Comando ou PowerShell para começar a usar o Volta

Instalação via ZIP:

1. Baixe o arquivo ZIP apropriado para sua arquitetura de sistema
2. Extraia o arquivo ZIP para um diretório de sua escolha (por exemplo, C:\Program Files\Volta)
3. Adicione o diretório extraído à sua variável de ambiente PATH do sistema
4. Abra uma nova janela de Prompt de Comando ou PowerShell para começar a usar o Volta

Passos de Instalação Manual no macOS

1. Baixe o tarball do macOS
2. Abra o Terminal e navegue até o local de download
3. Extraia o tarball e execute o script de instalação:

   tar xzf volta-2.0.2-macos.tar.gz
   ./volta-2.0.2-macos/install.sh

4. O script de instalação irá:
   • Colocar os binários do Volta em ~/.volta/bin
   • Atualizar seu arquivo de configuração do shell para adicionar o Volta ao seu PATH
5. Reinicie seu terminal ou execute source ~/.bashrc (ou seu arquivo de configuração do shell correspondente)

Passos de Instalação Manual no Linux

1. Baixe o tarball Linux apropriado para sua arquitetura de sistema (x86_64 ou ARM)
2. Abra o Terminal e navegue até o local de download
3. Extraia o tarball e execute o script de instalação:

   tar xzf volta-2.0.2-linux.tar.gz
   ./volta-2.0.2-linux/install.sh

4. O script de instalação irá:
   • Colocar os binários do Volta em ~/.volta/bin
   • Atualizar seu arquivo de configuração do shell para adicionar o Volta ao seu PATH
5. Reinicie seu terminal ou execute source ~/.bashrc (ou seu arquivo de configuração do shell correspondente)

Escolhendo a Versão Padrão do Node

Esta é a versão que o Volta usa em todos os lugares fora de projetos com versões fixas.

Para escolher uma versão específica do Node, execute:

volta install node@22.5.1

Ou para usar a versão LTS mais recente, execute:

volta install node

Usando o Volta para Gerenciar Seu Projeto

Usar o Volta em seu projeto é simples. Basta executar:

volta pin node@16

Isso adicionará uma seção volta ao seu arquivo package.json, garantindo que todos os membros do projeto usem a mesma versão do Node.js.

Você também pode fixar o gerenciador de pacotes:

volta pin npm@8

Assim, sempre que npm for executado em seu projeto, o Volta garantirá que a versão especificada seja usada.