Como instalar o Docker no Windows 11: guia de 5 minutos (2025)

Sua plataforma de lançamento em 5 minutos para o Docker no Windows 11

Docker is an open platform that has fundamentally changed modern software development. It leverages containerization to package applications and their dependencies into lightweight, isolated, and portable units called containers. Essa tecnologia resolve com elegância o clássico e muitas vezes frustrante problema do “na minha máquina funciona”, garantindo que um aplicativo rode de forma consistente nos ambientes de desenvolvimento, teste e produção. Ao final deste guia completo, qualquer desenvolvedor ou entusiasta de tecnologia terá um ambiente Docker totalmente funcional no seu PC com Windows 11, pronto para criar, compartilhar e executar aplicativos em contêineres com confiança.   

A promessa de “5 minutos” no título se refere especificamente ao tempo ativo de instalação e execução de comandos que o usuário vai gastar. É importante ter expectativas realistas: os períodos de espera passiva por downloads de software, reinicializações do sistema e a configuração inicial única do Windows Subsystem for Linux (WSL) não entram nessa estimativa. Este guia foi estruturado para deixar o processo ativo o mais rápido e livre de erros possível, tratando dos pré-requisitos a fundo desde o início.  

Este relatório oferece um roteiro completo para o processo de instalação. Ele começa com uma verificação prévia criteriosa dos requisitos de sistema, passa pela instalação do WSL 2 e do Docker Desktop, cobre a verificação da configuração e termina com o lançamento de um contêiner prático de servidor web Nginx no mundo real.   

Para começar, vale entender alguns conceitos centrais do Docker. Uma Imagem é um modelo somente leitura que contém o código do aplicativo, um runtime, ferramentas do sistema e todas as dependências necessárias. A   

Contêiner é uma instância viva e em execução de uma imagem. É o ambiente autocontido onde o aplicativo é executado.   

Docker Desktop é o aplicativo fácil de instalar para Windows que reúne o Docker Engine (o serviço central em segundo plano, ou daemon), a interface de linha de comando (CLI) para interagir com ele e outras ferramentas essenciais em um único pacote amigável. O principal benefício desse ecossistema é a consistência que ele oferece, o que acelera bastante os fluxos de trabalho de desenvolvimento e reduz bugs relacionados ao ambiente.   

Verificação prévia: seu PC com Windows 11 está pronto para o Docker?

Dedicar alguns minutos a esta lista de verificação prévia é o passo mais importante para garantir uma instalação tranquila e rápida. Esta seção foi criada para tratar de forma proativa os pontos de falha mais comuns, evitando horas de solução de problemas com mensagens de erro obscuras mais tarde. Um número significativo de falhas de instalação não se deve ao próprio Docker, mas a uma cascata de configurações incorretas do sistema. Por exemplo, uma configuração de virtualização desativada no firmware do computador impedirá que o Subsistema Windows para Linux (WSL 2) funcione corretamente. Isso, por sua vez, fará com que a instalação do Docker Desktop falhe com erros vagos como “Erro inesperado do WSL” ou “Este aplicativo não pode ser executado no seu PC”. Esta lista de verificação quebra essa cadeia de falhas antes que ela comece, transformando uma experiência potencialmente frustrante em algo simples.   

Requisitos de sistema em detalhes

Antes de continuar, é essencial confirmar que a máquina atende aos requisitos oficiais de sistema do Docker Desktop no Windows 11. Os requisitos mais recentes são os seguintes :   

• Sistema operacional: É necessária uma versão de 64 bits do Windows 11. Pode ser a edição Home, Pro, Enterprise ou Education. Recomenda-se fortemente a versão 22H2 ou superior para melhor compatibilidade e desempenho.
• Processador: O sistema precisa ter um processador de 64 bits com Second Level Address Translation (SLAT). Quase todas as CPUs modernas fabricadas na última década têm esse recurso.
• RAM: É necessário no mínimo 4 GB de RAM no sistema. Porém, para uma experiência fluida e responsiva, recomenda-se fortemente 8 GB de RAM ou mais. Tanto o Docker Desktop quanto os contêineres que ele executa consomem memória, e 4 GB podem virar um gargalo significativo durante o desenvolvimento.   

A etapa mais crítica: ativar a virtualização de hardware

Docker on Windows does not run applications natively; it relies on hardware virtualization to run a lightweight Linux kernel through WSL 2. If this feature is disabled in the system’s BIOS/UEFI, Docker Desktop cannot function.   

Como verificar se a virtualização está ativada

Dá para fazer uma verificação rápida sem reiniciar o sistema:

1. Pressione Ctrl + Shift + Esc para abrir o Gerenciador de Tarefas do Windows.
2. Vá até a Desempenho aba.
3. Selecione CPU no painel da esquerda.
4. Do lado direito, procure o Virtualização status. Se aparecer Ativado, nenhuma ação adicional é necessária nesta etapa. Se aparecer Desativado, é preciso ativá-la nas configurações de BIOS/UEFI antes de continuar.   

Como ativar a virtualização na BIOS/UEFI

Ativar a virtualização exige reiniciar o computador e entrar nas configurações de firmware. Os passos exatos variam entre fabricantes, mas o processo geral é o mesmo.

O método moderno para acessar as configurações de firmware UEFI no Windows 11 é o seguinte :   

1. Abra o Configurações app, navegue até Sistemae depois selecione Recuperação.
2. Na seção “Inicialização avançada”, clique no Reiniciar agora botão.
3. O computador vai reiniciar no Ambiente de Recuperação do Windows. A partir daí, selecione Solução de problemas > Opções avançadas > Configurações de firmware UEFI e clique em Reiniciar.

Como alternativa, o método tradicional é pressionar uma tecla específica durante a sequência inicial de boot. A tecla correta depende do fabricante.   

Dentro do menu da BIOS/UEFI, a configuração de virtualização geralmente fica em uma aba “Advanced”, “CPU Configuration” ou “Security”. A opção aparece como Intel Virtualization Technology (VT-x), AMD-V, ou SVM Mode. Essa configuração precisa ser alterada para   

Ativado. Depois de ativá-la, é fundamental salvar as alterações e sair da BIOS/UEFI, o que faz o computador reiniciar.

Para ajudar nesse processo, a tabela a seguir lista as teclas de acesso à BIOS/UEFI mais comuns dos principais fabricantes de PCs.

Fabricante	Teclas comuns
Dell	F2, F12
HP	Esc, F10
Lenovo	F1, F2, Fn+F2
ASUS	F2, Del
MSI / Gigabyte	Del
Tabela 1: teclas de acesso à BIOS/UEFI mais comuns por fabricante, compiladas a partir de manuais do usuário e documentação de suporte.

A base: instalar o Windows Subsystem for Linux (WSL 2)

Com os pré-requisitos confirmados, o próximo passo é instalar a base sobre a qual o Docker vai rodar: o Windows Subsystem for Linux, versão 2 (WSL 2). O Docker Desktop usa o WSL 2 como backend para executar contêineres Linux diretamente no Windows, oferecendo desempenho quase nativo, inicialização mais rápida e integração de sistema de arquivos superior em comparação com o backend antigo do Hyper-V.   

A instalação com um único comando

A Microsoft simplificou a instalação do WSL 2 em um único comando poderoso.

1. Abrir Windows PowerShell ou Prompt de Comando com permissões elevadas, clicando com o botão direito no ícone dele no Menu Iniciar e selecionando Executar como administrador.
2. Execute o comando a seguir: Trecho de códigowsl --install

Este único comando automatiza várias etapas que antes precisavam ser feitas manualmente. Ele ativa os recursos necessários “Virtual Machine Platform” e “Windows Subsystem for Linux”, baixa o kernel Linux mais recente da Microsoft, define o WSL 2 como versão padrão e instala a distribuição Ubuntu do Linux por padrão.   

Reinicialização e configuração após a instalação

Depois que o comando termina, é preciso reiniciar o sistema para concluir a instalação dos novos recursos do Windows.Ao reiniciar, uma janela de console do Ubuntu abre automaticamente para concluir a configuração inicial. Esse processo envolve criar um novo nome de usuário e uma nova senha UNIX. Vale notar que essas credenciais são do ambiente Linux e totalmente separadas das credenciais de login padrão do Windows.   

O evento principal: instalar o Docker Desktop

Com o WSL 2 pronto, o sistema já está preparado para a instalação principal do Docker Desktop.

Baixar o instalador correto

Baixe o instalador oficial diretamente do site do Docker para garantir a autenticidade e obter a versão mais recente.   

Um detalhe crítico e muitas vezes esquecido é a arquitetura do sistema. O instalador para processadores Intel e AMD padrão é o x86_64 (ou AMD64) versão. Os fóruns da comunidade estão cheios de relatos de usuários que encontraram imediatamente o erro “Este aplicativo não pode ser executado no seu PC” porque baixaram por engano o instalador ARM64, que é destinado a dispositivos como o Surface Pro X. A interface da página de download às vezes pode ser confusa, por isso é fundamental verificar duas vezes se a versão correta está sendo baixada.   

O processo de instalação

1. Localize o arquivo Docker Desktop Installer.exe baixado.
2. Dê um duplo clique no instalador para executá-lo. Ele vai pedir privilégios de administrador, que são necessários para a instalação.  
3. A tela principal de configuração traz uma escolha crucial. Verifique se a “Use WSL 2 instead of Hyper-V”opção está marcada. Isso configura o Docker para usar o backend moderno e recomendado, com desempenho ideal. A opção de adicionar um atalho na área de trabalho é uma questão de preferência do usuário.   

Permissões pós-instalação (o docker-users grupo)

Embora os direitos de administrador sejam necessários para a instalação, eles não são exigidos no uso diário do Docker. Porém, para que uma conta de usuário padrão (não administrador) consiga se comunicar com o daemon do Docker, ela precisa ser adicionada ao docker-users grupo de segurança local, criado durante a instalação.   

Para adicionar um usuário a este grupo:

1. Abra o Gerenciamento do Computador utilitário. Você encontra ele pela busca do Menu Iniciar. Ele precisa ser executado como administrador.
2. No painel esquerdo, navegue até Usuários e Grupos Locais > Grupos.
3. Localize e clique com o botão direito no docker-users grupo e selecione Adicionar ao grupo….
4. Clique em Adicionar… botão, digite o nome da conta de usuário que receberá acesso ao Docker e clique em OK.
5. Depois de adicionar o usuário, é essencial sair do Windows e entrar de novo. Essa etapa é obrigatória para a nova associação ao grupo valer; uma simples reinicialização nem sempre basta.   

Decolagem! Verificação e seu primeiro contêiner real

Com a instalação e a configuração prontas, chegou a hora de verificar tudo e lançar um contêiner. Esta seção confirma que todos os componentes funcionam juntos corretamente e traz um resultado concreto.

O aperto de mão pela linha de comando

Abra um novo terminal do PowerShell ou do Prompt de Comando. Se a conta de usuário foi adicionada ao docker-users grupo, este terminal deve não ser executado como administrador, para testar se as permissões estão funcionando corretamente.

Primeiro, verifique se a CLI do Docker consegue se comunicar com o daemon do Docker conferindo a versão:

Trecho de código

docker --version

Isso deve retornar a versão do Docker instalada, por exemplo, Docker version 25.0.3, build 4debf41.

Em seguida, execute o comando para listar os contêineres ativos:

Trecho de código

docker ps

Como ainda não há contêineres em execução, esse comando deve retornar uma tabela vazia, apenas com os cabeçalhos das colunas (CONTAINER ID, IMAGE etc.). Essa resposta vazia e bem-sucedida confirma que a CLI está conectada corretamente ao Docker Engine.   

O ritual do “Hello World”

O primeiro passo tradicional no mundo do Docker é executar a hello-world imagem. Isso serve como um teste definitivo do sistema inteiro.

Trecho de código

docker run hello-world

Esse comando executa várias ações: verifica se a hello-world a imagem localmente, baixa-a do repositório de imagens do Docker Hub se não for encontrada, cria um novo contêiner a partir dessa imagem, executa o contêiner e imprime uma mensagem de confirmação no terminal antes de sair. Uma execução bem-sucedida mostra uma mensagem que começa com “Hello from Docker!”   

Aplicação prática: lançar um servidor web Nginx

Enquanto hello-world confirma que o sistema funciona, não demonstra o uso prático. Um primeiro passo muito mais envolvente e instrutivo é iniciar um servidor web ativo. Isso apresenta conceitos essenciais como mapeamento de portas e modo desanexado, oferecendo um resultado interativo que consolida o entendimento. Essa abordagem faz a ponte entre uma simples verificação de instalação e uma aplicação real e prática.   

Para lançar um contêiner de servidor web Nginx, execute o comando a seguir:

Trecho de código

docker run -d -p 8080:80 --name my-web-server nginx

Cada parte deste comando tem uma função específica:

• docker run: o comando principal para criar e iniciar um novo contêiner.
• -d ou --detach: executa o contêiner em segundo plano, liberando o terminal para outros comandos.
• -p 8080:80 ou --publish 8080:80: mapeia a porta 8080 da máquina host (o PC) para a porta 80 dentro do contêiner. O Nginx escuta na porta 80 por padrão, então isso o torna acessível pelo navegador do host.
• --name my-web-server: atribui ao contêiner um nome legível, para facilitar o gerenciamento.
• nginx: especifica a imagem oficial do Nginx a ser usada, que o Docker vai baixar do Docker Hub.

Para verificar se o servidor web está rodando, abra um navegador e acesse o endereço http://localhost:8080. A página “Welcome to nginx!” deve aparecer, confirmando que o contêiner está em execução e acessível.

Para uma demonstração ainda mais poderosa, a página padrão pode ser personalizada usando uma montagem de vínculo (bind mount). Isso vincula um diretório da máquina host diretamente ao sistema de arquivos do contêiner.

1. Primeiro, pare e remova o contêiner existente: docker stop my-web-server seguido por docker rm my-web-server.
2. Crie uma nova pasta na área de trabalho chamada my-site.
3. Dentro dessa pasta, crie um novo arquivo de texto chamado index.html.
4. Abrir index.html e adicione o seguinte conteúdo: <h1>Olá do meu primeiro contêiner Docker!</h1>.
5. Agora, execute um novo contêiner com um volume (-v) para montar o diretório local. O caminho precisa ser absoluto.Trecho de códigodocker run -d -p 8080:80 --name my-web-server -v C:\Users\YourUsername\Desktop\my-site:/usr/share/nginx/html nginx (substitua YourUsername pelo nome de usuário real do Windows).
6. Atualize o navegador em http://localhost:8080. Agora ele vai mostrar a mensagem personalizada “Hello from my first Docker container!”. Isso demonstra o poder dos bind mounts para desenvolvimento ao vivo.   

Seu kit essencial de comandos Docker

Agora que um contêiner está rodando, alguns comandos essenciais são necessários para gerenciá-lo. Esta seção funciona como um guia rápido de referência para as operações mais comuns do dia a dia no Docker, permitindo que você interaja e controle imediatamente seu novo ambiente em contêineres.   

Comando	Descrição	Exemplo de uso
docker ps	Lista todos os contêineres em execução no momento.	docker ps
docker ps -a	Lista todos os contêineres, incluindo os que estão parados.	docker ps -a
docker stop <name_or_id>	Para um contêiner em execução de forma controlada.	docker stop my-web-server
docker start <name_or_id>	Inicia um contêiner que estava parado.	docker start my-web-server
docker rm <name_or_id>	Remove um contêiner parado permanentemente.	docker rm my-web-server
docker images	Lista todas as imagens Docker armazenadas localmente na máquina.	docker images
docker rmi <image_name>	Remove uma imagem local (somente se nenhum contêiner estiver usando).	docker rmi nginx
docker logs <name_or_id>	Busca os logs da saída padrão de um contêiner.	docker logs my-web-server
docker logs -f <name_or_id>	Acompanha a saída de logs em tempo real, transmitindo os novos logs.	docker logs -f my-web-server
docker exec -it <name> <cmd>	Executa um comando dentro de um contêiner em execução (por exemplo, abre um shell).	docker exec -it my-web-server bash
Tabela 2: lista de comandos Docker essenciais para iniciantes.

Solução de problemas: seu guia para erros comuns de instalação & execução

Mesmo com uma preparação cuidadosa, problemas podem surgir. Esta seção funciona como um kit de primeiros socorros, tratando dos erros de instalação e execução mais comuns. As perguntas foram formuladas para corresponder às mensagens de erro exatas que os usuários provavelmente vão pesquisar, o que torna este guia um recurso valioso durante a solução de problemas.

FAQ 1: por que recebo um “Unexpected WSL error”?

• Sintomas: O Docker Desktop não inicia e exibe um pop-up com este erro, muitas vezes mencionando problemas de direitos de acesso ou sugerindo uma wsl --shutdown comando.   
• Soluções: Estes passos devem ser tentados na ordem.
  1. Reinício simples: Abra o PowerShell e execute wsl --shutdown. Este comando para completamente a máquina virtual do WSL 2. Aguarde alguns segundos e tente reiniciar o Docker Desktop. Isso costuma resolver problemas de estado transitório.   
  2. Redefinição da pilha de rede: Se o problema persistir, pode ser devido a uma corrupção na pilha de rede do Windows que possibilita a comunicação com o WSL. Abra o PowerShell como administrador e execute netsh winsock reset. É necessário reiniciar o sistema após este comando.   
  3. Verifique o tipo de inicialização do hypervisor: Certifique-se de que o hypervisor do Windows esteja configurado para iniciar automaticamente. Abra um PowerShell como administrador e execute bcdedit /set hypervisorlaunchtype Auto, depois reinicie.   
  4. Ciclo completo de reativação: Como último recurso, os componentes de virtualização podem ser totalmente reinstalados. Em um PowerShell como administrador, execute os seguintes comandos para desativar os recursos: DISM /Online /disable-Feature /FeatureName:VirtualMachinePlatform DISM /Online /disable-Feature /FeatureName:Microsoft-Windows-Subsystem-Linux Reinicie o computador. Depois, abra outro PowerShell como administrador e reative-os: DISM /Online /enable-Feature /FeatureName:Microsoft-Windows-Subsystem-Linux DISM /Online /enable-Feature /FeatureName:VirtualMachinePlatform Reinicie mais uma vez.   

FAQ 2: o Docker Desktop não inicia depois que eu o fecho ou reinicio o PC. O que está errado?

• Sintomas: O aplicativo funcionou perfeitamente após a instalação inicial, mas agora não inicia. O ícone do Docker pode aparecer na bandeja do sistema e depois desaparecer, ou simplesmente nada acontece.
• Solução: Esse problema costuma ser causado por processos em segundo plano persistentes que não foram encerrados corretamente.
  1. Abrir Gerenciador de tarefas (Ctrl + Shift + Esc).
  2. Vá para a Detalhes aba.
  3. Ordene por nome e procure por processos chamados Docker Desktop.exe ou que envolvam o backend do Docker.
  4. Selecione cada um desses processos e clique em Encerrar tarefa.
  5. Depois que todos os processos relacionados forem encerrados, tente iniciar o Docker Desktop novamente.   

FAQ 3: o instalador diz “Este aplicativo não pode ser executado no seu PC”. Como corrijo isso?

• Sintomas: O Docker Desktop Installer.exe falha imediatamente ao ser executado com esta mensagem de erro genérica do Windows.
• Solução:
  1. Causa principal: O motivo mais comum deste erro é uma incompatibilidade de arquitetura. O usuário provavelmente baixou o ARM64 instalador para um PC padrão com processador Intel ou AMD. Volte ao site oficial do Docker e certifique-se de que a x86_64 / AMD64 versão seja baixada.   
  2. Causa secundária: Se o instalador correto foi usado, este erro indica que um pré-requisito essencial do sistema não foi atendido. Volte à Seção 1 deste guia e verifique se a virtualização de hardware está habilitada na BIOS/UEFI.

FAQ 4: minha instalação falhou com um erro sobre virtualização ou WSL.

• Sintomas: O instalador mostra uma mensagem de erro como “a instalação do WSL 2 está incompleta”, “o Docker Desktop exige um backend WSL 2” ou outra mensagem que mencione explicitamente a virtualização.
• Solução: Isso é um indicador claro de que um pré-requisito foi ignorado ou não está configurado corretamente.
  1. Reinicie e entre na BIOS/UEFI para confirmar que Intel VT-x ou AMD-V é Ativado. Este é o ponto de falha mais comum.
  2. Certifique-se de que o recurso do Windows “Plataforma de Máquina Virtual” esteja ativado. Para ter certeza, execute dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart em um PowerShell como administrador e reinicie.   

FAQ 5: recebo erros de “permissão negada” ou “o daemon não está em execução” quando executo dockercomandos.

• Sintomas: Em um terminal sem privilégios de administrador, comandos como docker ps falham com um erro indicando que o cliente não consegue se conectar ao daemon do Docker.
• Solução: Este é um problema clássico de permissões.
  1. Confirme que a conta de usuário atual é membro do docker-users grupo local, conforme detalhado na Seção 3.
  2. É fundamental que o usuário sair do Windows e entrar de novo para que a mudança na associação ao grupo seja aplicada ao seu token de segurança. Apenas reiniciar o computador ou fechar e reabrir o terminal não é suficiente.

Conclusão: sua jornada com o Docker começa agora

Seguindo este guia, o usuário preparou seu sistema Windows 11, instalou os pré-requisitos necessários como o WSL 2, instalou e configurou o Docker Desktop, verificou a instalação completa e iniciou um contêiner Nginx real. Essa conquista proporciona uma base poderosa e estável para o desenvolvimento de software moderno.

Com um ambiente Docker funcional, a jornada pela conteinerização realmente começa. Os próximos passos lógicos para ampliar essa base incluem:

• Aprender Docker Compose: Para aplicativos compostos por vários serviços (como uma aplicação web, um banco de dados e uma camada de cache), o Docker Compose é a ferramenta padrão. Ele permite definir e gerenciar uma pilha completa de aplicativos multicontêiner usando um único arquivo de configuração YAML, simplificando implantações complexas em um único comando.   
• Escrever um Dockerfile: O verdadeiro poder do Docker se revela ao empacotar aplicativos personalizados. O próximo passo é aprender a escrever um Dockerfile, que é um arquivo de texto com instruções passo a passo para criar uma imagem Docker personalizada a partir do código-fonte de um aplicativo.   
• Explorar o Docker Hub: O Docker Hub é um vasto registro público que contém milhares de imagens pré-criadas para diversos aplicativos e serviços. É um recurso inestimável para encontrar imagens oficiais e também é a plataforma para compartilhar imagens personalizadas com a comunidade ou com uma equipe privada.