Como Instalar o Docker no Debian 13: Guia Completo

O Debian 13 (Trixie) está em desenvolvimento e já é uma excelente base para servidores e estações de trabalho. Se você quer containerizar suas aplicações, o Docker é a ferramenta certa. Neste guia, você aprenderá a instalar o Docker Engine diretamente do repositório oficial, garantindo sempre a versão mais recente e atualizações automáticas.

Pré-requisitos

• Uma instalação limpa ou existente do Debian 13 (Trixie).
• Acesso ao terminal com permissões de sudo ou usuário root.
• Conexão com a internet.

Passo 1: Atualizar o sistema

Antes de instalar novos pacotes, sempre atualize os repositórios e pacotes existentes:

sudo apt update && sudo apt upgrade -y

Passo 2: Instalar dependências necessárias

O Docker precisa de alguns pacotes auxiliares para adicionar repositórios HTTPS e gerenciar chaves GPG:

sudo apt install -y ca-certificates curl gnupg lsb-release apt-transport-https software-properties-common

Passo 3: Adicionar a chave GPG oficial do Docker

Isso garante que os pacotes baixados sejam realmente da Docker Inc. e não tenham sido alterados:

sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

Passo 4: Adicionar o repositório do Docker

Agora adicione o repositório oficial à lista de fontes do APT. O comando abaixo detecta automaticamente a arquitetura do seu sistema:

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

Atualize novamente os repositórios para reconhecer o novo source:

sudo apt update

Passo 5: Instalar o Docker Engine

Instale os pacotes principais do Docker:

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

Esse comando instala:

• docker-ce – o motor de containers.
• docker-ce-cli – a interface de linha de comando.
• containerd.io – o runtime de containers.
• docker-buildx-plugin – plugin para builds avançados.
• docker-compose-plugin – plugin do Docker Compose V2.

Passo 6: Verificar a instalação

Para confirmar que o Docker foi instalado corretamente, execute a imagem de teste oficial:

sudo docker run hello-world

Se tudo estiver certo, você verá uma mensagem de boas-vindas explicando que a instalação está funcionando.

Passo 7: Executar Docker sem sudo (opcional)

Por padrão, o Docker exige privilégios de root. Para usar o comando docker com seu usuário comum, adicione-o ao grupo docker:

sudo usermod -aG docker $USER
newgrp docker

Nota: Se o newgrp docker não funcionar imediatamente, faça logout e login novamente para aplicar as alterações.

Comandos úteis do Docker

# Ver versão instalada
docker --version

# Listar containers em execução
docker ps

# Listar todos os containers (parados e em execução)
docker ps -a

# Listar imagens baixadas
docker images

# Iniciar/parar/reiniciar um container
docker start <nome_ou_id>
docker stop <nome_ou_id>
docker restart <nome_ou_id>

# Ver logs de um container
docker logs <nome_ou_id>

Como desinstalar o Docker

Se precisar remover o Docker, execute:

sudo apt purge -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo rm -rf /var/lib/docker
sudo rm -rf /etc/apt/keyrings/docker.gpg /etc/apt/sources.list.d/docker.list

Conclusão

Você acaba de instalar o Docker no Debian 13 usando o repositório oficial. Essa é a forma mais recomendada, pois garante que você sempre terá as últimas correções de segurança e novos recursos. Agora é só começar a criar e gerenciar seus containers!

Se tiver dúvidas ou encontrar algum erro durante a instalação, deixe um comentário abaixo.