Habilitar e configurar o WSL2

Antes de usar o WSL Dashboard, seu sistema Windows deve ter o ambiente WSL 2 habilitado e configurado corretamente. Esta seção guiará você através da configuração básica necessária.

1. Verificar os requisitos do sistema

O WSL 2 tem requisitos mínimos de versão do Windows. Pressione Win + R, digite winver para verificar sua versão:

• Windows 10: versão 1903 ou superior, e a versão de build deve ser 18362 ou superior.
• Windows 11: todas as versões são compatíveis.

IMPORTANT

Se sua versão for muito antiga, primeiro atualize seu sistema através do "Windows Update".

2. Habilitar virtualização de hardware

O WSL 2 funciona com base na tecnologia de virtualização, portanto, você deve habilitar Virtualization Technology no BIOS/UEFI da placa-mãe.

• Método de verificação: Abra o "Gerenciador de Tarefas" -> guia "Desempenho" -> "CPU".
• Verificar status: Confirme que o status "Virtualização" no canto inferior direito mostra "Habilitado".
• Modo de habilitação: Se não estiver habilitado, você precisa reiniciar o computador e acessar as configurações do BIOS/UEFI, encontrar uma opção similar a Intel VT-x ou AMD-V e definir como Enabled.

3. Habilitar recursos relacionados do Windows

Você precisa habilitar os recursos do Windows "Windows Subsystem for Linux" e "Virtual Machine Platform".

Método A: Via interface gráfica (recomendado)

1. Pressione Win + S, procure e abra "Ativar ou desativar recursos do Windows".
2. Marque as duas opções a seguir:
   • Windows Subsystem for Linux (Subsistema do Windows para Linux)
   • Virtual Machine Platform (Plataforma de Máquina Virtual)
3. Clique em "OK" e reinicie o computador quando solicitado.

Método B: Via linha de comando (com privilégios de administrador)

Execute o PowerShell como administrador e execute os seguintes comandos:

# Habilitar WSL
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# Habilitar plataforma de máquina virtual
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Após a execução, reinicie manualmente o computador.

4. Instalar/atualizar o kernel do WSL

Versões modernas do Windows podem obter atualizações do WSL através da Microsoft Store.

• URL de download: Microsoft Store - Windows Subsystem for Linux
• Download manual: Se não puder usar a loja, você pode baixar o pacote de instalação .msixbundle ou .msi mais recente do WSL GitHub Releases para instalação offline.

5. Definir o WSL 2 como versão padrão

Para garantir que as novas distribuições instaladas usem o WSL 2 por padrão, execute no terminal:

wsl --set-default-version 2

Problemas comuns

• Erro 0x80370102: Normalmente causado por virtualização não habilitada no BIOS ou conflitos com o Hyper-V.
• Alternância entre WSL 1 e WSL 2: Você pode usar wsl --set-version <nome da distribuição> 2 para atualizar uma instância WSL 1 existente para o WSL 2.