nereumelo / setup-wsl

Setup WSL

1. Instalar a versão atual do terminal PowerShell

2. Abrir o PowerShell como administrador

3. Instalar o WSL

   wsl --install

   Nota: Caso encontre problemas para executar o WSL2, consulte a sessão de troubleshooting

   
   3.1. Listar as distribuições Linux instaladas

   wsl -l -v

   Nota: Também são listados a versão do WSL e o status de execução de cada distribuição

   
   3.2. Listar as distribuições Linux disponíveis para instalação

   wsl -l -o

   
   3.3. Instalar uma distribuição

   wsl --install -d <DISTRO-NAME>

   
   3.4. Executar uma distribuição instalada

   wsl -d <DISTRO-NAME>

   
   

4. Configurar a distribuição instalada

   4.1. Configuração automática

   bash <(curl -fsSL https://raw.githubusercontent.com/nereumelo/setup-wsl/main/dialog.sh)

   Nota: Caso deseje configurar manualmente, consulte a sessão de Configuração manual

   
   

Configuração manual

1. Atualizar a distribuição e seus pacotes

   source <(curl -fsSL https://raw.githubusercontent.com/nereumelo/setup-wsl/main/scripts/setup.sh)

   
   

   Nota: Caso apareça a mensagem 'You should reboot', abra o terminal PowerShell e desligue as distribuições em execução. Após isso, basta abrir novamente o terminal da distribuição e prosseguir com o setup.

   wsl --shutdown

   
   

2. Instalar o Git

   source <(curl -fsSL https://raw.githubusercontent.com/nereumelo/setup-wsl/main/scripts/bash/install-git.sh)

   
   

3. Instalar o Docker Engine

   source <(curl -fsSL https://raw.githubusercontent.com/nereumelo/setup-wsl/main/scripts/bash/install-docker.sh)

   
   

4. Instalar o Node Version Manager (NVM)

   source <(curl -fsSL https://raw.githubusercontent.com/nereumelo/setup-wsl/main/scripts/bash/install-nvm.sh)

   
   

5. Instalar o terminal ZSH

   source <(curl -fsSL https://raw.githubusercontent.com/nereumelo/setup-wsl/main/scripts/zsh/install-zsh.sh)

   
   

Troubleshooting

Caso encontre problemas para executar a versão 2 do WSL

• Baixar o pacote de atualização do kernel Linux para o WSL

• Definir o WSL 2 como a sua versão padrão

  wsl --set-default-version 2