docker / Guias

Como liberar espaço no Docker sem remover volumes

Primeiro identifique o que ocupa espaço e onde estão os dados da aplicação. Um objeto Docker não utilizado ainda pode ser importante para você.

Os exemplos usam Bash; consulte as referências para os detalhes do seu ambiente.

Confira antes de remover

docker system df -v
docker ps -a
docker volume ls

Compare o espaço de imagens, contêineres, volumes e cache de build. O espaço recuperável é uma estimativa de diagnóstico, não uma prévia de exclusão. Examine contêineres importantes com docker inspect <container> e confira suas montagens antes da limpeza.

Escolha uma limpeza específica

ComandoO que removeO que conferir
docker image pruneImagens dangling, sem tag e sem uso.Se uma build local antiga ainda é importante.
docker container pruneTodos os contêineres parados.As camadas graváveis e a configuração desses contêineres.
docker builder pruneCache de build elegível.Se refazer a build terá um custo alto.

Execute apenas o comando adequado ao seu objetivo e leia a confirmação. Remover contêineres parados perde os dados mantidos apenas em suas camadas graváveis. Arquivos em bind mounts e volumes usam armazenamento separado.

Entenda a limpeza mais ampla

docker system prune

Esse comando remove contêineres parados, redes não utilizadas, imagens dangling e cache de build não utilizado. Volumes ficam de fora por padrão. Adicionar -a também inclui imagens sem associação a contêineres, inclusive imagens com tag que você poderia reutilizar.

Preservar volumes não garante que todos os dados da aplicação sobrevivam: dados mantidos apenas dentro de um contêiner removido são perdidos. Faça backup dos dados importantes antes.

Confira o resultado e os limites

docker system df -v
docker ps -a
docker volume ls

Confira se os volumes necessários permanecem e se a aplicação consegue acessar os dados. Não adicione --volumes nem execute docker volume prune neste procedimento. docker compose down -v também fica fora desse plano de limpeza.

Docker system prune não tem opção de simulação dry-run. No Docker Desktop, reduzir o espaço usado pelo Docker não significa que o arquivo do disco virtual diminuirá imediatamente na mesma proporção.

Referências

Todos os guias