Docker ocupando espaço na VPS: como limpar imagens, volumes e logs com segurança

Tempo de leitura: 3 minutos

O disco da VPS encheu de novo e, investigando, a pasta /var/lib/docker é a maior de todas. É normal: a cada atualização, imagens antigas ficam para trás, contêineres parados acumulam e os logs crescem sem limite. O comando docker system prune e alguns ajustes simples resolvem e evitam que volte a acontecer.

Disco NVMe com folga deixa os seus contêineres rodando sem sustos. Se você ainda não tem onde rodar isso, a Cloud VPS Brasil já entrega o servidor pronto.

Passo 1: ver quanto o Docker ocupa

docker system df

A saída separa o espaço em quatro grupos: Images, Contêineres, Local Volumes e Build Cache, com a coluna RECLAIMABLE mostrando quanto dá para recuperar.

Para detalhes por item:

docker system df -v

Passo 2: limpeza segura

O comando abaixo remove contêineres parados, redes sem uso, imagens sem nome (as antigas que ficaram para trás nas atualizações) e o cache de build:

docker system prune

Ele pede confirmação e mostra quanto espaço foi liberado. Volumes não são apagados, então os dados dos seus bancos continuam seguros.

Passo 3: limpeza mais agressiva

Para remover também imagens que não estão sendo usadas por nenhum contêiner:

docker system prune -a

Cuidado: se um contêiner estiver parado de propósito, a imagem dele também vai embora. Ela é baixada de novo na próxima vez que o contêiner subir.

Sobre os volumes

Volumes guardam dados persistentes: bancos de dados, uploads, configurações. Liste os que não estão ligados a nenhum contêiner:

docker volume ls -f dangling=true

Só apague depois de conferir o nome de cada um. O comando docker volume prune remove volumes órfãos de forma definitiva. Na dúvida, faça backup antes.

Passo 4: limitar o tamanho dos logs

Por padrão, cada contêiner grava o log num arquivo que cresce sem limite. Para descobrir os maiores:

sudo du -sh /var/lib/docker/containers/*/*-json.log | sort -h | tail

Para limitar todos os contêineres novos, crie ou edite o arquivo /etc/docker/daemon.json:

{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  }
}

Reinicie o Docker:

sudo systemctl restart docker

O limite vale para contêineres criados depois da mudança. Recrie os existentes com docker compose up -d --force-recreate para que eles também passem a respeitar.

No docker-compose.yml, dá para definir por serviço:

    logging:
      options:
        max-size: "10m"
        max-file: "3"

Passo 5: automatizar

Uma limpeza semanal no cron mantém tudo sob controle:

0 4 * * 0 docker system prune -f > /dev/null 2>&1

O -f pula a confirmação. Não coloque -a nem --volumes na limpeza automática.

Se o disco continuar cheio

O Docker pode não ser o único culpado. Use o guia de disco cheio na VPS Linux para encontrar outras pastas grandes.

Espaço e desempenho para os seus contêineres

Com limpeza periódica e logs limitados, o Docker para de engolir o disco da VPS. Na Cloud VPS Brasil você conta com Intel Xeon Gold, SSD NVMe, baixa latência, tráfego ilimitado, preço fixo em reais e suporte humano via WhatsApp e ticket. Fale com a equipe pelo WhatsApp e escolha o plano ideal para o seu projeto.