Windows - Instalando o WSL e o Docker

Source: Dev.to

Pré-requisitos

• Windows 11 ou Windows 10 com atualizações que suportem WSL 2.
• Virtualização por hardware habilitada na BIOS/UEFI.
• Conexão à internet para baixar distribuições, pacotes e imagens Docker.

Instalar o WSL (passo rápido)

No PowerShell em modo Administrador execute:

wsl --install

Esse comando habilita os recursos necessários para executar o WSL e instala a distribuição padrão do Ubuntu (pode ser alterada).

Verificar versão e distribuições

wsl --version
wsl -l -v

Novas instalações feitas com wsl --install são, por padrão, configuradas para WSL 2.
Para instruções oficiais e detalhes, consulte a documentação do WSL.

Opção com interface gráfica: Docker Desktop com integração WSL 2

1. Baixe e instale o Docker Desktop para Windows.
2. Em Settings > General ative Use the WSL 2 based engine.
3. Em Resources > WSL Integration habilite a distro que você usa.

Abra o terminal dentro do WSL: os comandos docker e docker compose estarão disponíveis.
Essa abordagem reduz conflitos e facilita para quem não tem familiaridade com a CLI. Para mais detalhes, acesse a documentação do Docker Desktop.

Alternativa: instalar Docker Engine dentro do Ubuntu (WSL 2)

Se preferir não usar o Docker Desktop, siga os passos dentro da sua distro Ubuntu:

sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg lsb-release

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
  sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] \
  https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io

sudo usermod -aG docker $USER

Depois, no PowerShell, reinicie a distro:

wsl --shutdown

Teste a instalação:

docker run --rm hello-world

Consulte o guia oficial de instalação do Docker Engine para Ubuntu.

Docker Compose

O Docker Compose é distribuído como plugin (v2+). Em Linux, instale o docker-compose-plugin pelo repositório Docker ou siga a página oficial de instalação do Compose. Se usar Docker Desktop, o Compose já vem integrado.

docker compose version

Exemplos práticos

Rodar um Nginx simples

docker run --name exemplo-nginx -p 8080:80 -d nginx:stable

Acesse no host:

docker‑compose.yml mínimo

services:
  web:
    image: nginx:stable
    ports:
      - "8080:80"

Subir o stack

docker compose up -d

Verificar containers

docker compose ps

Visualizar logs

docker compose logs -f

Referências e links úteis

• Microsoft – Como instalar o WSL (pt‑BR)
• Microsoft – WSL config (wsl.conf) / systemd
• Docker – Docker Desktop: WSL 2 backend / integração
• Docker – Instalar Docker Engine no Ubuntu
• Docker – Instalar o plugin Docker Compose
• Docker – Documentação geral do Compose