🐳 Como instalar o Docker no Ubuntu — guia passo a passo para iniciantes

Se você está no começo da graduação, talvez no 2º semestre, e começou a ouvir falar de Docker em aulas, vídeos ou projetos, este guia foi feito para você 😄

Aqui você vai aprender, de forma simples e prática, como instalar o Docker no Ubuntu, entender o que cada etapa faz e testar se tudo ficou funcionando corretamente.

📘 O que é Docker?
Docker é uma ferramenta que permite empacotar e executar aplicações em containers. Pense neles como “caixinhas” organizadas que carregam tudo que um programa precisa para funcionar.

🎯 O que vamos fazer

• Atualizar o Ubuntu
• Instalar os pacotes necessários
• Adicionar o repositório oficial do Docker
• Instalar a versão estável mais recente
• Testar se o Docker está funcionando
• Permitir usar Docker sem sudo

🧰 Pré-requisitos

Antes de começar, você precisa:

• Ter um computador com Ubuntu instalado
• Ter acesso a um usuário com permissão de administrador
• Ter internet funcionando
• Abrir o Terminal do Ubuntu

💡 Dica para iniciantes:
O terminal pode parecer assustador no início, mas ele é uma das ferramentas mais importantes para quem estuda computação. Vá copiando e executando um comando de cada vez com calma.

1️⃣ Atualizar a lista de pacotes do sistema

Primeiro, vamos atualizar as informações dos programas disponíveis no Ubuntu e instalar possíveis atualizações.

sudo apt update
sudo apt upgrade -y

O que isso faz?

• sudo: executa o comando com permissão de administrador
• apt update: atualiza a lista de pacotes disponíveis
• apt upgrade -y: instala atualizações pendentes automaticamente

2️⃣ Instalar dependências necessárias

Agora vamos instalar alguns pacotes que ajudam o Ubuntu a baixar arquivos com segurança e trabalhar com repositórios externos.

sudo apt install -y ca-certificates curl gnupg

Explicando:

• ca-certificates: ajuda na validação de certificados digitais 🔐
• curl: permite baixar arquivos pela internet 🌐
• gnupg: ajuda a verificar assinaturas e chaves de segurança

3️⃣ Adicionar a chave GPG oficial do Docker

Essa etapa garante que os pacotes do Docker sejam reconhecidos como oficiais e confiáveis.

sudo install -m 0755 -d /etc/apt/keyrings

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

sudo chmod a+r /etc/apt/keyrings/docker.gpg

O que está acontecendo aqui?

• Criamos uma pasta para armazenar chaves de segurança
• Baixamos a chave oficial do Docker
• Salvamos essa chave em formato adequado para o sistema
• Liberamos permissão de leitura para o arquivo

🛡️ Por que isso é importante?
Porque o Ubuntu precisa ter certeza de que os pacotes vêm realmente do Docker e não de uma fonte falsa.

4️⃣ Adicionar o repositório oficial do Docker

Agora vamos dizer ao Ubuntu onde ele deve procurar os pacotes do Docker.

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

Em palavras simples:

• arch=$(dpkg --print-architecture): identifica a arquitetura do seu computador, como amd64
• VERSION_CODENAME: detecta automaticamente a versão do seu Ubuntu
• stable: indica que queremos a versão estável do Docker ✅

5️⃣ Atualizar novamente a lista de pacotes

Como adicionamos um novo repositório, precisamos atualizar a lista de pacotes mais uma vez.

sudo apt update

6️⃣ Instalar o Docker

Agora sim: vamos instalar o Docker e alguns componentes importantes que vêm junto com ele.

sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

O que esses pacotes fazem?

• docker-ce: o motor principal do Docker 🐳
• docker-ce-cli: comandos que você usa no terminal
• containerd.io: componente que ajuda a executar containers
• docker-buildx-plugin: facilita builds avançados de imagens
• docker-compose-plugin: permite usar docker compose

7️⃣ Testar se a instalação funcionou

O jeito mais clássico de testar o Docker é rodar o container hello-world.

sudo docker run hello-world

Se tudo estiver certo, o Docker vai baixar uma imagem de teste e mostrar uma mensagem informando que a instalação foi bem-sucedida 🎉

8️⃣ Ver a versão instalada

Se você quiser confirmar a versão instalada no sistema, use:

docker --version

Ou, para ver mais detalhes:

docker version

📌 Importante:
Esse método instala a versão estável mais recente disponível no repositório oficial do Docker para sua versão do Ubuntu.

9️⃣ Usar Docker sem precisar digitar sudo

Por padrão, muitos comandos do Docker exigem sudo. Para facilitar sua vida, você pode adicionar seu usuário ao grupo docker.

sudo usermod -aG docker $USER

Depois disso, você precisa sair e entrar novamente na sessão do Ubuntu. Se quiser tentar aplicar no terminal atual, use:

newgrp docker

Agora teste sem sudo:

docker run hello-world

🔎 Comandos úteis para o dia a dia

Verificar se o serviço Docker está rodando

sudo systemctl status docker

Iniciar o Docker manualmente

sudo systemctl start docker

Fazer o Docker iniciar junto com o sistema

sudo systemctl enable docker

Verificar o Docker Compose

docker compose version

⚠️ Problemas comuns

Erro: permission denied
Normalmente isso acontece porque o usuário ainda não foi adicionado ao grupo docker, ou porque você ainda não fez logout/login após o comando.

Erro por conflito com instalação antiga
Se você já tentou instalar Docker antes usando outro método, pode ser necessário remover pacotes antigos:

sudo apt remove docker docker-engine docker.io containerd runc

📝 Resumo rápido

1. Atualize o sistema
2. Instale dependências
3. Adicione a chave oficial do Docker
4. Adicione o repositório oficial
5. Atualize os pacotes novamente
6. Instale o Docker
7. Teste com hello-world
8. Opcionalmente, habilite uso sem sudo

🎓 Conclusão

Instalar o Docker no Ubuntu não é tão complicado quanto parece. Quando você entende o papel de cada etapa, tudo faz mais sentido e o terminal deixa de ser um bicho de sete cabeças 😄

Para quem está começando na computação, aprender Docker cedo é excelente, porque ele aparece em desenvolvimento de software, devops, banco de dados, deploy e até em projetos acadêmicos.

🚀 Próximo passo:
Depois de instalar, experimente aprender:

• docker ps
• docker images
• docker run
• docker compose up

Esses comandos já vão te colocar em outro nível.