🐳 Instalando o Docker em uma VPS Ubuntu

Guia completo para instalar e configurar o Docker Engine em servidores Ubuntu (20.04, 22.04 ou 24.04).

Pré-requisitos

VPS com Ubuntu 20.04, 22.04 ou 24.04
Acesso root ou usuário com sudo
Conexão com a internet

1. Atualizar o sistema

apt update && apt upgrade -y

2. Instalar dependências

apt install -y ca-certificates curl gnupg lsb-release

3. 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

4. Adicionar o repositório oficial

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

5. Instalar o Docker

apt update

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

6. Verificar a instalação

docker version
docker compose version

7. Testar com Hello World

docker run hello-world

Se aparecer a mensagem Hello from Docker!, a instalação está correta.

8. Habilitar o Docker na inicialização

systemctl enable docker
systemctl start docker

9. Permitir uso sem `sudo` (opcional)

Por padrão, o Docker exige sudo. Para rodar como usuário comum:

usermod -aG docker $USER

!!! warning "Atenção" Após esse comando, faça logout e login novamente para aplicar as permissões. Em servidores onde você opera como root, esse passo não é necessário.

Comandos úteis pós-instalação

Comando	Descrição
`docker ps`	Lista containers em execução
`docker ps -a`	Lista todos os containers
`docker images`	Lista imagens baixadas
`docker compose up -d`	Sobe um stack em background
`docker compose down`	Para e remove os containers do stack
`docker compose logs -f`	Acompanha os logs em tempo real
`docker system prune -f`	Remove recursos não utilizados

Estrutura recomendada para stacks

Organize cada serviço em sua própria pasta dentro de um diretório central:

~/docker/
├── traefik/
│   └── docker-compose.yml
├── mkdocs/
│   └── docker-compose.yml
└── n8n/
    └── docker-compose.yml

!!! tip "Dica" Usar um diretório por stack facilita o gerenciamento, os backups e a manutenção individual de cada serviço.