Lance um VPS Docker autohospedado em minutos

Step 01 — Contrate o VPS e conecte-se

Escolha um VPS Ubuntu em um local próximo dos seus usuários ou das APIs externas que os contêineres consomem e conecte-se por SSH. Os comandos abaixo rodam em um shell root.

ssh root@your-server-ip

Se o login direto como root estiver desativado, conecte-se com a sua conta comum e execute sudo -i.

Step 02 — Instale o Docker Engine e o Compose

Instale o Docker Engine e o plugin Compose a partir do repositório apt oficial do Docker:

apt updateapt install ca-certificates curlinstall -m 0755 -d /etc/apt/keyringscurl -fsSL https://download.docker.com/linux/ubuntu/gpg \  -o /etc/apt/keyrings/docker.ascchmod a+r /etc/apt/keyrings/docker.asc tee /etc/apt/sources.list.d/docker.sources <<EOFTypes: debURIs: https://download.docker.com/linux/ubuntuSuites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")Components: stableArchitectures: $(dpkg --print-architecture)Signed-By: /etc/apt/keyrings/docker.ascEOF apt updateapt install docker-ce docker-ce-cli containerd.io \  docker-buildx-plugin docker-compose-pluginsystemctl enable --now dockerdocker run --rm hello-world

Step 03 — Aponte o seu domínio para o VPS

Crie um registro A apontando o domínio da aplicação para o VPS Docker. O Caddy precisa que o domínio resolva corretamente antes de emitir o certificado HTTPS.

Type: AName: appValue: your-server-ip

Libere o tráfego TCP de entrada nas portas 80 e 443 no firewall do servidor e no painel do seu provedor.

Step 04 — Descreva a stack Docker

Crie o diretório do projeto:

mkdir -p /opt/docker-appcd /opt/docker-app

Crie o .env e substitua o valor de exemplo por uma senha longa e segura para URL:

POSTGRES_PASSWORD=replace-with-a-long-random-string

Crie o Caddyfile:

app.yourdomain.com {    reverse_proxy app:8080}

Crie o compose.yaml. Substitua your-org/your-app:1.4.2 pela imagem e versão usadas pela sua aplicação. O nome antigo docker-compose.yml continua funcionando.

services:  app:    image: your-org/your-app:1.4.2    restart: unless-stopped    environment:      DATABASE_URL: postgres://app:${POSTGRES_PASSWORD}@db:5432/app    depends_on:      db:        condition: service_healthy   db:    image: postgres:16    restart: unless-stopped    environment:      POSTGRES_DB: app      POSTGRES_USER: app      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}    volumes:      - db-data:/var/lib/postgresql/data    healthcheck:      test: ["CMD-SHELL", "pg_isready -U app -d app"]      interval: 5s      timeout: 5s      retries: 10   caddy:    image: caddy:2    restart: unless-stopped    ports:      - "80:80"      - "443:443"    volumes:      - ./Caddyfile:/etc/caddy/Caddyfile:ro      - caddy-data:/data      - caddy-config:/config volumes:  db-data:  caddy-data:  caddy-config:

Somente o Caddy publica portas no host. A aplicação e o banco de dados seguem acessíveis apenas dentro da rede privada do Compose.

Step 05 — Suba a stack

Proteja o arquivo de ambiente, suba os contêineres e confira o status:

chmod 600 .envdocker compose up -ddocker compose ps

O Caddy obtém e renova o certificado HTTPS automaticamente e redireciona as requisições HTTP para HTTPS. Os volumes nomeados preservam os dados do banco e os certificados do Caddy quando os contêineres são recriados.

• A aplicação sobe antes de o banco estar pronto — o depends_on simples garante a ordem de inicialização, não a prontidão. Dê um health check ao banco e dependa dele com condition: service_healthy, como acima.
• As portas publicadas ignoram o ufw — o Docker roteia o tráfego dos contêineres na tabela nat, antes das cadeias que o ufw usa, então uma porta publicada responde mesmo quando o ufw diz que está fechada. Publique apenas o proxy; apontar para 127.0.0.1 também publica a porta, só que limitada à interface de loopback.
• Os pulls começam a falhar no meio do deploy — o Docker Hub permite 100 pulls a cada 6 horas por endereço IPv4 ou sub-rede IPv6 /64 sem autenticação, e 200 a cada 6 horas em uma conta Personal gratuita. Rode docker login no servidor antes de um deploy que baixa muitas imagens.
• Os dados sumiram depois que o contêiner foi recriado — dados guardados na camada gravável do contêiner desaparecem quando ele é removido. Mantenha dados persistentes em um volume nomeado ou bind mount.