Docker na VPS: como instalar e usar

O que é

Docker empacota aplicações em contêineres que rodam isolados dentro da sua VPS. Toda VPS da WFree é KVM: uma máquina virtual completa, com kernel próprio. Por isso o Docker funciona em qualquer plano (Nano, Micro, Small, Medium e Large), dentro dos recursos do plano.

As imagens de Debian 13 e Ubuntu 24.04 LTS vêm sem Docker. Você instala, com os passos abaixo. Não há imagem com Docker pronto, nem no pedido nem na Reinstalação: o Docker é sempre instalado por você.

Fique de olho no tamanho. Nano, Micro e Small têm 20 GB de disco, e o Nano tem 1 GB de memória. Imagens de contêiner ocupam espaço rápido, e cada contêiner consome memória.

A VPS é um serviço não gerenciado: o suporte não instala nem configura aplicações. Este artigo mostra o caminho; a configuração dos seus contêineres é sua.

Como fazer

1. Entre na VPS como root: ssh root@IP. Sem SSH, use o Console da área do cliente (Serviços > Meus Serviços > sua VPS > Console).
2. Atualize o sistema: apt update && apt upgrade.
3. Instale pelo script oficial do Docker, que já traz o Docker Compose:

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

4. Ative o serviço: systemctl enable --now docker.
5. Teste: docker run --rm hello-world. Para o Compose: docker compose version.
6. Libere a porta do seu contêiner. A entrada da VPS vem fechada (só SSH e ping liberados): crie na página Firewall uma regra de entrada para a porta que o contêiner publica (por exemplo, 80 e 443 para um site).

Se der errado

• "Cannot connect to the Docker daemon": o serviço não está rodando. Veja com systemctl status docker e suba com systemctl start docker. O motivo aparece em journalctl -u docker -n 50.
• "no space left on device": docker system df mostra quanto imagens, volumes e cache ocupam. Limpe com docker system prune (apaga o que não está em uso). Se precisar de mais disco, contrate o adicional de espaço extra pela área do cliente: o disco cresce sem reinstalar e sem reiniciar. Veja o artigo de upgrade de plano e adicionais.
• Contêiner no ar, mas a porta não abre de fora: confira o mapeamento em docker ps, as regras da página Firewall e o firewall interno da VPS. Docker e ufw costumam se atropelar; prefira controlar as portas pela página Firewall do painel.
• Contêiner morre sozinho: rode dmesg | grep -i -E "killed process|out of memory". Se for falta de memória, limite o contêiner com --memory ou suba de plano. Depois do upgrade, a CPU e a memória novas só valem depois do Reiniciar do painel; reiniciar por dentro da VPS não aplica.
• Contêiner de e-mail não entrega: a rede da WFree bloqueia a saída pela porta 25 (SMTP direto). Use um relay autenticado nas portas 587 ou 465. Se você precisa mesmo da porta 25, peça a liberação por ticket (artigo "Enviar e-mail da VPS (porta 25 bloqueada)").
• Quer recomeçar do zero: use Reinstalação no painel. Ela apaga tudo, inclusive os snapshots, mas antes faz sozinha um backup completo. Leva cerca de 4 minutos.

Quando abrir um ticket

Abra um ticket em Suporte > Abrir Ticket quando o Docker não subir numa VPS recém-instalada seguindo os passos acima, ou quando a VPS não conseguir baixar imagens com a saída livre no Firewall. Informe o hostname, o plano, o sistema (Debian 13 ou Ubuntu 24.04 LTS) e a saída de docker info e journalctl -u docker -n 50. Nunca escreva senhas no ticket: a WFree não pede senha. A configuração da sua aplicação dentro dos contêineres fica com você.