Como instalar o WSL no Windows 10 (2026)

• Para instalar o WSL no Windows 10, abra o Prompt de Comando (ou PowerShell ) como administrador e execute o comando wsl --install para instalar todos os componentes do WSL2 e a distribuição Linux Ubuntu.
• Se você deseja instalar uma distribuição específica, execute o wsl --install -d DISTRO-NAMEcomando, e para atualizar o kernel do WSL, execute o wsl --updatecomando.
• Você também pode instalar o WSL e distribuições Linux a partir da Microsoft Store. 

ATUALIZADO EM 02/01/2026: O Subsistema Windows para Linux (WSL) é um recurso que permite usar o Linux nativamente sobre o  Windows 10 (usando uma máquina virtual leve) sem precisar configurar outro ambiente de virtualização com Hyper-V, VMware Workstation ou Oracle VirtualBox, ou usar uma configuração de inicialização dupla . Em outras palavras, o WSL dá acesso às poderosas ferramentas e utilitários de linha de comando do Linux, enquanto você ainda usa sua área de trabalho familiar do Windows.

Este ambiente Linux para usuários do Windows possui duas versões, geralmente chamadas de WSL1 e WSL2. A versão original (ou WSL1 ) foi projetada como uma integração direta com o sistema operacional, utilizando uma camada de tradução para interagir com as chamadas de sistema do Windows. O problema era o desempenho lento, especialmente em operações com o sistema de arquivos e tarefas que exigiam muitos recursos.

Por outro lado, o WSL2 usa uma máquina virtual leve para executar um kernel Linux completo com o hipervisor Microsoft Hyper-V. Ele oferece desempenho significativamente mais rápido e maior compatibilidade com aplicativos, o que significa que pode ser usado para fluxos de trabalho de desenvolvimento mais complexos, execução de aplicativos exigentes e uso de contêineres Docker.

Essa funcionalidade é voltada principalmente para aplicativos de linha de comando, mas você também pode instalar e executar aplicativos com interface gráfica (GUI) utilizando ferramentas como X11 ou Wayland .

Por fim, embora você ainda possa acessar o WSL1, é recomendável configurar e usar o WSL2. A Microsoft simplificou o processo de instalação do WSL no Windows 10 para um único comando que baixa e instala todos os componentes necessários, incluindo a plataforma de máquina virtual e o Ubuntu Linux por padrão.

Neste guia , vou ensinar os passos para instalar o Subsistema Windows para Linux (versão 2) no Windows 10.

• Instale o WSL no Windows 10 a partir do Prompt de Comando ou do PowerShell.
• Instale o WSL no Windows 10 a partir da Microsoft Store.
• Instalar o WSL no Windows 10 (versões antigas)

Importante: Embora a maioria dos computadores venha com virtualização de hardware já habilitada, você deve garantir que a virtualização esteja ativada no firmware BIOS (UEFI) do seu computador .

Instale o WSL no Windows 10 a partir do Prompt de Comando ou do PowerShell.

Para instalar o Subsistema Windows para Linux no Windows 10, siga estes passos:

1. Abra o menu Iniciar no Windows 10.

    

    

2. Procure por "Prompt de Comando" (ou "PowerShell" ), clique com o botão direito do mouse no primeiro resultado e selecione a opção " Executar como administrador" .

3. Digite o seguinte comando para instalar o WSL no Windows 10 e pressione Enter :

   wsl --instalar

   

4. Reinicie o computador para concluir a instalação do WSL no Windows 11.

5. Continue com a configuração da distribuição Linux conforme necessário.

Após concluir os passos, o Subsistema Windows para Linux será instalado no seu computador com a versão mais recente da distribuição Ubuntu Linux, pois esse é o comportamento padrão.

Se você receber o código de erro 14107 , isso pode indicar que o recurso "Plataforma de Máquina Virtual" não está habilitado no seu computador. Nesse caso, abra Configurações > Recursos opcionais > Mais recursos do Windows , marque a opção "Plataforma de Máquina Virtual" e clique no botão "OK" para adicionar os componentes. Agora você pode executar o comando de instalação do WSL novamente.

Instale o WSL com a distribuição específica.

Para instalar o WSL com uma distribuição específica no Windows 10, siga estes passos:

1. Abra o menu Iniciar .

2. Procure por "Prompt de Comando" , clique com o botão direito do mouse no primeiro resultado e selecione a opção " Executar como administrador" .

3. Digite o seguinte comando para visualizar uma lista das distribuições WSL disponíveis para instalação no Windows 10 e pressione Enter :

   wsl --lista --online

   Observação rápida: No momento em que este texto foi escrito, você pode instalar Ubuntu, Debian, Kali Linux, openSUSE e SUSE Linux Enterprise Server.

4. Digite o seguinte comando para instalar o WSL com uma distribuição específica no Windows 10  e pressione Enter :

   wsl --install -d NOME-DA-DISTRIBUIÇÃO

   

   Lembre-se de substituir “DISTRO-NAME” no comando pelo nome da distribuição que deseja instalar, como Debian .

5. Reinicie o computador.

6. Continue com a configuração da distribuição Linux conforme necessário.

Após concluir os passos, os componentes do Subsistema Windows para Linux 2 serão instalados na distribuição Linux que você especificou. 

Atualizar kernel do WSL

Para atualizar o kernel do WSL para a versão mais recente, siga estes passos:

1. Abra o menu Iniciar .

2. Procure por "Prompt de Comando" , clique com o botão direito do mouse no primeiro resultado e selecione a opção " Executar como administrador" .

3. Digite o seguinte comando para atualizar o kernel do WSL e pressione Enter :

   wsl --atualizar

   

Após concluir os passos, se houver uma atualização disponível, ela será baixada e instalada no dispositivo.

Se o comando de atualização não funcionar, abra Configurações > Atualização e Segurança > Windows Update > Opções avançadas e ative a opção " Receber atualizações para outros produtos da Microsoft ao atualizar o Windows" .

Instale o WSL no Windows 10 a partir da Microsoft Store.

Você também pode instalar o Subsistema Windows para Linux e distribuições da Microsoft Store. No entanto, esse processo exige a ativação dos recursos "Plataforma de Máquina Virtual" e "Subsistema Windows para Linux" antes da instalação da plataforma e das distribuições Linux.

1. Ative os componentes de virtualização do WSL

Para instalar os componentes de sistema necessários para executar o Linux no Windows 10, siga estes passos:

1. Abra o menu Iniciar .

2. Pesquise por " Ativar ou desativar recursos do Windows" e clique no primeiro resultado para abrir o aplicativo.

3. Selecione a opção “Plataforma de Máquina Virtual” .

   

4. Verifique a opção “Subsistema Windows para Linux” .

5. Clique no botão OK .

6. Clique no botão Reiniciar .

Após concluir essas etapas, você poderá prosseguir com os passos para baixar o WSL da Microsoft Store.

2. Instale o aplicativo Subsistema Windows para Linux.

Para instalar o WSL no Windows 11 a partir da Microsoft Store, siga estes passos:

1. Abra a página da loja do Subsistema Windows para Linux .

2. Clique no botão Instalar .

3. Clique no botão “Abrir a Microsoft Store” (se aplicável).

4. Clique novamente no botão Instalar .

   

3. Instale a distribuição Linux

Para instalar uma distribuição Linux a partir da Microsoft Store, siga estes passos:

1. Abra o aplicativo Microsoft Store .

2. Procure por distribuições Linux, como o Debian .

3. Clique no botão Obter .

   

4. Clique no botão Abrir .

Após concluir os passos, a camada Linux será instalada no Windows 10, incluindo o suporte para aplicativos GUI do Linux e a distribuição Linux.

Instalar o WSL2 no Windows 10 (versões antigas)

Alternativamente, você ainda pode instalar o WSL no Windows 10 versão 1909 e versões anteriores usando os processos legados. O processo requer a ativação do WSL1, a Plataforma de Máquina Virtual, a conversão das distribuições existentes (se aplicável) e a configuração do Subsistema Windows para Linux 2 como o novo padrão para futuras instalações de distribuições.

Se você possui um sistema ARM64, a integração com Linux é suportada na versão 2004 e superiores.

Habilitar o Subsistema Windows para Linux

Se você ainda não estiver usando o Linux no Windows 10, você deve habilitar o Subsistema Windows para Linux (versão 1) seguindo estes passos:

1. Abra o menu Iniciar no Windows 10.

2. Pesquise por " Ativar ou desativar recursos do Windows" e clique no primeiro resultado para abrir o aplicativo.

3. Verifique a opção “ Subsistema Windows para Linux” .

   

4. Clique no botão OK .

5. Clique no botão Reiniciar .

Após concluir as etapas, você deve ativar o recurso Plataforma de Máquina Virtual.

Habilitar a plataforma de máquina virtual

Para ativar a Plataforma de Máquina Virtual no Windows 10, siga estes passos:

Importante: A placa-mãe e o processador devem suportar virtualização, e a opção deve estar habilitada no Sistema Básico de Entrada/Saída (BIOS) ou na Interface Unificada de Firmware Extensível (UEFI).

1. Abra o menu Iniciar .

2. Pesquise por PowerShell , clique com o botão direito do mouse no primeiro resultado e selecione a opção Executar como administrador .

3. Digite o seguinte comando para ativar o recurso Plataforma de Máquina Virtual e pressione Enter :

   Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform

   

4. Reinicie o computador.

Após concluir os passos, você poderá definir o Subsistema Windows para Linux versão 2 como a nova arquitetura padrão e converter as distribuições existentes.

Habilitar o Subsistema Windows para Linux 2

Para começar a usar o WSL2 ou converter distribuições WSL para WSL2, siga estes passos:

1. Baixe esta atualização do kernel do WSL 2 (obrigatória).

2. Clique duas vezes no arquivo wsl_update_x64.msi e aplique a atualização.

3. Abra o menu Iniciar .

4. Pesquise por PowerShell , clique com o botão direito do mouse no primeiro resultado e selecione a opção Executar como administrador .

5. Digite o seguinte comando para definir o Subsistema Windows para Linux 2 como sua arquitetura padrão para novas distribuições que você instalar e pressione Enter :

   wsl --definir-versão-padrão 2

   

6. (Opcional) Digite o seguinte comando para converter a distribuição de WSL para WSL 2 e pressione Enter :

   wsl --definir-versão Ubuntu 2

   

   No comando, substitua “Ubuntu” pelo nome da distribuição que você deseja converter. Se você não souber o nome da distribuição, use o wsl -l -vcomando.

Após concluir os passos, seu dispositivo começará a usar a nova versão do Subsistema Windows para Linux como arquitetura padrão.

Confirme a plataforma de distribuição.

Para confirmar se as distribuições estão usando o Subsistema Windows para Linux 2, siga estes passos:

1. Abra o menu Iniciar .

2. Pesquise por PowerShell , clique com o botão direito do mouse no primeiro resultado e selecione a opção Executar como administrador .

3. Digite o seguinte comando para verificar a versão da distribuição e pressione Enter :

   wsl --list --verbose

4. Confirme se a versão da distribuição é 2 .

   

Após concluir as etapas, você saberá se o processo foi bem-sucedido ou se precisa solucionar algum problema em alguma delas.

Atualização de 2 de janeiro de 2026: Este guia foi atualizado para garantir a precisão e refletir as alterações no processo.