Guia Passo a Passo: Instalação do Docker Desktop no Windows e macOS
Comece com o Docker instalando o Docker Desktop no Windows e macOS. Este guia passo a passo abrange pré-requisitos, instruções de download, procedimentos de instalação e etapas de verificação inicial para ambos os sistemas operacionais. Aprenda a configurar seu ambiente de desenvolvimento para uma conteinerização eficiente.
Guia Passo a Passo: Instalando o Docker Desktop no Windows e macOS
O Docker Desktop é o ponto de partida usual quando você deseja executar contêineres em um laptop Windows ou macOS. A instalação é simples, mas algumas configurações do sistema podem impedir que o Docker inicie após a conclusão do instalador.
Este guia orienta você na instalação do Docker Desktop no Windows e macOS e, em seguida, verifica se a CLI do Docker, o Docker Engine e um contêiner de teste funcionam corretamente.
O que o Docker Desktop Instala
O Docker Desktop oferece um ambiente Docker local com a CLI do Docker, o Docker Engine, o Docker Compose, um painel de controle desktop e suporte opcional ao Kubernetes. No Windows, o Docker Desktop normalmente executa contêineres Linux através do WSL 2. No macOS, ele executa contêineres dentro de uma máquina virtual Linux leve.
Para o desenvolvimento do dia a dia, isso significa que você pode executar comandos como:
docker run hello-world
docker compose up
docker build -t my-app .
Você não precisa instalar um pacote separado do Docker Engine primeiro.
Verifique os Pré-requisitos Primeiro
O Docker altera os requisitos de plataforma ao longo do tempo, portanto, verifique a documentação atual do Docker antes de instalar em máquinas mais antigas. Na maioria das configurações atuais, você deve confirmar estes itens básicos.
Requisitos do Windows
Use uma edição do Windows de 64 bits suportada e mantenha o Windows atualizado. O Docker Desktop funciona melhor com o backend WSL 2, portanto, instale o WSL antes ou durante a configuração:
wsl --install
Execute esse comando de um PowerShell ou Prompt de Comando elevado e reinicie se o Windows solicitar.
Verifique também a virtualização de hardware. Abra o Gerenciador de Tarefas, vá para Desempenho, selecione CPU e procure por Virtualização: Ativada. Se estiver desativada, ative-a nas configurações da BIOS ou UEFI.
O Docker Desktop é para ambientes Windows desktop, não para Windows Server.
Requisitos do macOS
Use uma versão suportada do macOS em um Apple silicon ou um Mac Intel. Baixe o instalador correto para o tipo do seu chip. Se você não tiver certeza de qual Mac possui, abra Menu Apple > Sobre Este Mac e verifique a linha do chip ou processador.
O Docker Desktop precisa de memória e espaço em disco suficientes para executar uma VM Linux e armazenar imagens. Se você planeja executar bancos de dados ou pilhas de vários serviços localmente, dê mais memória ao Docker nas configurações após a instalação.
Instalar o Docker Desktop no Windows
Baixe o Docker Desktop do site oficial do Docker. Evite espelhos de download de terceiros para ferramentas de desenvolvimento.
Execute o instalador .exe e mantenha a opção WSL 2 ativada quando ela aparecer. Se o instalador oferecer para adicionar componentes necessários do Windows, permita. Após a instalação, reinicie o computador se solicitado.
Abra o Docker Desktop no menu Iniciar. Na primeira inicialização, aceite os termos de licença e deixe o Docker concluir sua configuração. Se o Docker relatar um problema com o WSL, atualize o WSL e tente novamente:
wsl --update
Se você usa um laptop corporativo, o software de segurança de endpoint pode interferir na virtualização ou na rede local. Nesse caso, verifique a política de Docker Desktop da sua empresa antes de alterar as configurações de firewall ou antivírus.
Instalar o Docker Desktop no macOS
Baixe o Docker Desktop para Mac do site oficial do Docker. Escolha o instalador para Apple silicon para Macs da série M e o instalador Intel para Macs Intel.
Abra o arquivo .dmg e arraste o Docker para a pasta Aplicativos. Inicie o Docker a partir de Aplicativos. O macOS pode solicitar sua senha ou permissão para instalar componentes auxiliares usados para rede e virtualização.
Quando o Docker Desktop iniciar, aguarde até que o ícone da barra de menus mostre que o Docker está em execução. A primeira inicialização pode demorar mais porque o Docker cria sua VM local e armazenamento.
Verificar a Instalação
Abra um terminal e verifique o cliente e o servidor Docker:
docker version
Você deve ver uma seção do cliente e uma seção do servidor. Se você vir apenas informações do cliente ou um erro sobre conexão com o daemon, o Docker Desktop não está em execução ou falhou ao iniciar.
Execute o contêiner de teste padrão:
docker run hello-world
O Docker baixa uma imagem pequena e a executa. Uma execução bem-sucedida imprime uma mensagem explicando que o Docker está funcionando.
Você também pode verificar o Docker Compose:
docker compose version
Use o comando docker compose separado por espaço para o Compose v2, que está incluído no Docker Desktop.
Ajustar as Primeiras Configurações
Abra as configurações do Docker Desktop após o primeiro teste bem-sucedido.
No Windows, verifique Recursos > Integração WSL e ative a integração para as distribuições Linux onde você executa comandos de desenvolvimento. Se você usa Ubuntu no WSL, isso permite executar docker do shell Ubuntu.
No Windows e no macOS, revise Recursos. Projetos pequenos podem funcionar bem com as configurações padrão, mas Kubernetes local, bancos de dados e grandes builds geralmente precisam de mais memória ou espaço em disco.
Ative o Kubernetes apenas se precisar de um cluster local de nó único. Deixá-lo desativado mantém o Docker Desktop mais leve.
Problemas Comuns de Instalação
Se o Docker não iniciar no Windows, primeiro confirme se a virtualização está ativada e o WSL está instalado:
wsl --status
Se o WSL estiver desatualizado, execute:
wsl --update
Se docker version não conseguir conectar ao daemon Docker, certifique-se de que o Docker Desktop está em execução e concluiu a inicialização. No macOS, verifique o ícone da barra de menus. No Windows, verifique a bandeja do sistema.
Se um contêiner de teste não conseguir acessar a rede, teste em uma rede diferente ou estado de VPN. Clientes VPN e proxies corporativos geralmente afetam a rede do Docker. O Docker Desktop possui configurações de proxy que você pode configurar quando seu ambiente exigir.
Assim que docker run hello-world funcionar, seu ambiente de contêiner local estará pronto. Um bom próximo passo é executar um serviço que você já conhece, como o Nginx:
docker run --rm -p 8080:80 nginx
Em seguida, abra http://localhost:8080. Se você vir a página de boas-vindas do Nginx, o Docker pode baixar imagens, iniciar contêineres e publicar portas em sua máquina.