Pedro Paulo

Como instalar o Docker e Docker Compose no Ubuntu 24.04 e derivados

por Pedro Paulo

Dica Rápida

Dica Rápida

Todo mundo que mexe com desenvolvimento chega numa hora que precisa do Docker. Aí vem a dúvida: instalo pelo apt mesmo ou pelo repositório oficial? Pelo apt padrão do Ubuntu funciona, mas a versão costuma estar bem atrás. O jeito certo — e que garante sempre versões atuais — é instalar direto pelo repositório oficial do Docker. Funciona no Ubuntu, Linux Mint, Pop!_OS, Zorin OS e qualquer outra distro baseada no Ubuntu 24.04.


1. Remova versões antigas (se houver)

Se você já tentou instalar Docker antes por outro método, limpe primeiro:

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

Se nunca instalou, esse comando não vai causar nenhum problema — pode rodar sem medo.


2. Instale as dependências necessárias

sudo apt update && sudo apt install -y ca-certificates curl gnupg

Esses pacotes permitem que o sistema baixe e verifique a chave GPG do repositório do Docker com segurança.


3. Adicione a chave GPG oficial do Docker

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

Essa chave garante que os pacotes que você vai baixar são mesmo do Docker — e não de qualquer lugar.


4. Adicione o repositório oficial

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

Atenção para usuários de Mint, Pop!_OS e Zorin: o truque aqui é o UBUNTU_CODENAME. Essas distros têm o próprio nome de versão, mas guardam internamente qual versão do Ubuntu elas são baseadas. Esse comando lê essa informação automaticamente — você não precisa alterar nada.


5. Instale o Docker e o Docker Compose

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

Após isso, você já tem tudo instalado: Docker Engine, Docker CLI e o Docker Compose como plugin nativo.


6. Teste se funcionou

sudo docker run hello-world

Se aparecer uma mensagem de boas-vindas do Docker, está tudo certo.


7. Use o Docker sem sudo

Por padrão, o Docker só pode ser executado com sudo. Para usar sem precisar digitar sudo toda vez, adicione seu usuário ao grupo docker:

sudo usermod -aG docker $USER

Depois, aplique a mudança na sessão atual sem precisar reiniciar:

newgrp docker

Pronto. Agora teste novamente, desta vez sem sudo:

docker run hello-world

Funcionou? Então está pronto para usar.


Como usar o Docker Compose

O Docker Compose agora vem como plugin do Docker (não é mais um binário separado). O comando mudou um pouco:

# Antes (versão antiga)
docker-compose up

# Agora (plugin oficial)
docker compose up

Só um espaço no lugar do hífen. Para subir seus serviços em segundo plano:

docker compose up -d

Para parar:

docker compose down

Instalação limpa, repositório oficial, sem surpresas. Da próxima vez que precisar subir um container, é só rodar.