WSL2, WSA ou Docker não iniciam

Sintoma

O comando wsl termina com erro em vez de iniciar o Linux, o Docker Desktop informa que a virtualização ou o Hyper-V não estão disponíveis, e os aplicativos Android e o emulador do Android Studio não iniciam.

Causas típicas

Os componentes de virtualização — Hyper-V e relacionados — foram desativados por um “otimizador”, por um pacote de tweaks ou estão corrompidos após uma atualização com falha do Windows. Sem eles, o WSL2, o WSA e o Docker não conseguem iniciar suas máquinas virtuais. A virtualização também é usada pelo subsistema de segurança: como ela se relaciona com as configurações do BoosterX está descrito no artigo «VBS (Virtualization Based Security)».

Correção no BoosterX

1. Abra o BoosterX → seção «Correções» (no menu à esquerda).
2. Na busca, digite «Linux».
3. Abra o cartão «Linux (WSL2), WSA (Android Studio), Docker» e clique em «Corrigir».
4. Reinicie o Windows.

A correção restaura o Hyper-V e ativa os componentes do Windows necessários para o funcionamento do WSL. O BoosterX pode ser baixado no site oficial boosterx.org.

Como verificar

Abra o terminal e execute wsl — o console do Linux deve abrir. Em seguida, inicie o Docker Desktop e o aplicativo Android: ambos os ambientes devem iniciar sem erros de virtualização.

Alternativa manual sem o BoosterX

Abra Painel de Controle → Programas → Programas e Recursos → Ativar ou desativar recursos do Windows e marque «Subsistema do Windows para Linux» e «Plataforma de Máquina Virtual»; nas edições em que ele está disponível, também «Hyper-V». Clique em OK, aguarde a instalação dos componentes e reinicie o PC. Depois, execute no terminal wsl --update para atualizar o kernel do WSL.

Se não ajudou

Se o Windows informar que a virtualização está desativada, verifique se ela está habilitada na BIOS/UEFI. Em seguida, consulte os registros do log de eventos do Windows que coincidam no tempo com o erro — a análise de incidentes é facilitada pelo EventX. Se a correção do BoosterX não ajudou ou o problema voltou, escreva para o suporte e anexe o texto do erro.

Última verificação: 2026-09-20. Catálogo completo de correções.