Utilizando o Docker Desktop no Windows 10 Home com WSL2

June 01, 2020

Logo do Docker

O que é o WSL?

Em tradução livre, o Windows Subsystem for Linux (WSL) permite que desenvolvedores executem um ambiente GNU/Linux diretamente no Windows, sem as burocracias de se utilizar uma máquina virtual.

Com o WSL, é possível instalar múltiplas distribuições Linux dentro do Windows e utilizar seus recursos de forma integrada ao sistema operacional da Microsoft. Você pode, por exemplo, navegar pelos diretórios das suas distribuições diretamente do Windows Explorer.

Por que diabos preciso do WSL2 para usar o Docker Desktop no Windows 10 Home?

A versão para Windows do Docker Desktop exige que o sistema operacional tenha suporte ao recurso de virtualização Hyper-V, que só está disponível nas versões Pro, Enterprise e Education.

No Docker, o suporte a hosts Linux é nativo, então utilizamos o WSL2 como “backend” para a execução da aplicação. Isso torna o Docker muito mais acessível - visto que as máquinas da maioria esmagadora das pessoas executa o Windows 10 Home e nem sempre realizar uma instalação dual boot é viável.

Instalando o WSL2 + Docker Desktop

Atualize o Windows 10

Garanta que seu Windows 10 esteja atualizado com o update de maio de 2020 (versão 2004). Para conferir, pressione a tecla Win + R e digite winver.

Captura de tela da janela "sobre o Windows" com a versão sublinhada.

Caso não esteja atualizado, baixe o assistente de atualização no site da Microsoft (botão atualizar agora). Faça atualização e reinicie a máquina.

Instalando o WSL2

Execute o PowerShell como administrador e execute os comandos abaixo, em ordem.

  1. habilite o WSL:

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

  1. habilite o recurso plataforma de máquina virtual:

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

  1. reinicie o computador.
  2. instale a atualização do kernel do WSL2, disponível no site da Microsoft.
  3. Reexecute o PowerShell como administrador e defina a versão 2 do WSL como padrão:

wsl --set-default-version 2

Instalando o Docker Desktop

Baixe e instale o Docker Desktop.

Na tela inicial, mantenha marcada a opção para habilitar o suporte a WSL2. Faça logout no Windows para concluir a instalação.

Agora é só seguir o tutorial de inicio rápido ou já abrir seus contêineres existentes e executá-los.

Captura de tela do aplicativo Docker Desktop.


Marcus Pereira é mineiro, desenvolvedor e LGBT. Quando não está programando ou jogando, está falando sobre tecnologia, videogames e música.

© 2020