Como instalar o Docker em uma VPS Ubuntu

O Docker é o runtime de containers mais usado no mundo e é pré-requisito para n8n, Evolution API, Supabase e muitas outras ferramentas. Este guia cobre os dois métodos oficiais de instalação: o script get.docker.com (mais rápido) e o repositório apt (recomendado para produção).

Instalação passo a passo

1. 1

   Atualizar o sistema

   Sincronize o índice de repositórios e atualize os pacotes existentes.

   bashCopiar

   apt update && apt upgrade -y

2. 2

   Remover versões antigas do Docker (se existirem)

   Versões antigas do Docker instaladas via repositório do Ubuntu devem ser removidas antes da instalação oficial.

   bashCopiar

   for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do
     apt remove -y $pkg 2>/dev/null
   done

   Dica

   Se nenhuma dessas versões estiver instalada, o apt simplesmente ignora os pacotes não encontrados.
3. 3

   Método A: instalar via repositório apt oficial (recomendado)

   Este método instala o Docker CE do repositório oficial, garantindo atualizações futuras via apt.

   bashCopiar

   # Instalar dependências para repositório HTTPS
   apt install -y ca-certificates curl
   
   # Adicionar a chave GPG oficial do Docker
   install -m 0755 -d /etc/apt/keyrings
   curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
     -o /etc/apt/keyrings/docker.asc
   chmod a+r /etc/apt/keyrings/docker.asc
   
   # Adicionar o repositório Docker
   echo \
     "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] \
     https://download.docker.com/linux/ubuntu \
     $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
     tee /etc/apt/sources.list.d/docker.list > /dev/null
   
   # Atualizar o índice e instalar o Docker
   apt update
   apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

4. 4

   Método B: instalar via script get.docker.com (mais simples)

   Para instalações rápidas ou automação, o script oficial detecta a distro e instala automaticamente.

   bashCopiar

   curl -fsSL https://get.docker.com -o get-docker.sh
   sh get-docker.sh

   Dica

   O Método B instala os mesmos pacotes do Método A. Use apenas um dos métodos — não execute os dois.
5. 5

   Verificar a instalação

   Confirme que Docker e o plugin Compose foram instalados corretamente.

   bashCopiar

   docker --version
   docker compose version
   
   # Testar com o container hello-world
   docker run hello-world

   Dica

   O Docker Compose está incluído como plugin nativo (`docker compose`), não como binário separado (`docker-compose`). Em sistemas novos, use sempre `docker compose` (com espaço).
6. 6

   Configurar o serviço systemd

   Garanta que o Docker inicia automaticamente após reinicializações do servidor.

   bashCopiar

   # Habilitar e iniciar o Docker
   systemctl enable docker
   systemctl start docker
   
   # Verificar status
   systemctl status docker

7. 7

   Adicionar usuário não-root ao grupo docker (opcional)

   Para usar o Docker sem `sudo`, adicione seu usuário ao grupo docker. Isso é conveniente mas concede permissões equivalentes a root.

   bashCopiar

   # Adicionar o usuário atual ao grupo docker
   usermod -aG docker $USER
   
   # Aplicar sem fazer logout (para a sessão atual)
   newgrp docker
   
   # Verificar
   docker ps

   Atenção

   Adicionar um usuário ao grupo docker é equivalente a conceder acesso root via socket. Em servidores de produção compartilhados, avalie se isso é necessário.
8. 8

   Verificar a configuração final

   Confirme que tudo está funcionando corretamente.

   bashCopiar

   # Status completo
   docker info
   
   # Teste de compose (cria um container nginx temporário)
   mkdir -p /tmp/docker-test && cd /tmp/docker-test
   cat > docker-compose.yml << 'EOF'
   services:
     web:
       image: nginx:alpine
       ports:
         - "8080:80"
   EOF
   
   docker compose up -d
   curl http://localhost:8080
   docker compose down
   cd / && rm -rf /tmp/docker-test

Troubleshooting

Perguntas frequentes