Guias do Levo · Desenvolvedores: tudo mais

Docker ocupando muito espaço em disco no Mac

No Mac, o Docker guarda tudo em um único arquivo de disco virtual, o Docker.raw, e esse arquivo cresce mas não encolhe sozinho. Rode docker system df para ver o que ocupa espaço, depois docker system prune e docker builder prune para liberá-lo.

Por que o Docker.raw é tão grande

Os contêineres rodam em uma pequena VM Linux, e o disco da VM é um único arquivo no seu Mac. O Docker Desktop define um tamanho máximo, muitas vezes 60 GB ou mais, e o arquivo cresce em direção a ele conforme você baixa imagens e faz builds. No Finder ele pode parecer bem maior do que é, porque é um arquivo esparso: ls -lh mostra o máximo, du -sh mostra o que realmente é usado.

O problema é que apagar imagens libera espaço dentro da VM, mas o arquivo no seu Mac não encolhe na hora. As versões recentes do Docker Desktop devolvem os blocos liberados ao macOS, mas em configurações mais antigas, ou depois de muita movimentação, pode ser preciso redimensionar o disco ou redefini-lo em Settings › Resources.

Como fazer você mesmo

Veja o que ocupa espaço

docker system df
docker system df -v

O primeiro comando mostra os totais de imagens, contêineres, volumes e cache de build, com uma coluna RECLAIMABLE. O segundo lista cada item. O cache de build é o discreto: depois de algumas semanas de builds, costuma ser a maior linha.

Libere o espaço

docker container prune
docker image prune -a
docker builder prune
docker system prune

• docker container prune remove os contêineres parados.
• docker image prune -a remove todas as imagens que nenhum contêiner usa, inclusive as com tag. Sem o -a, remove só as imagens dangling.
• docker builder prune remove o cache de build. Adicione --all para incluir o cache usado por builds com tag.
• docker system prune cuida de contêineres, redes, imagens dangling e cache de build de uma vez. Ele não remove volumes, a menos que você adicione --volumes.

Os volumes são onde ficam bancos de dados, arquivos enviados e tudo o que o seu arquivo compose montou em um volume nomeado. docker system prune --volumes remove todo volume que nenhum contêiner usa no momento, inclusive o do Postgres do projeto que você vai abrir na semana que vem. Liste-os com docker volume ls e remova um de cada vez com docker volume rm <name> depois de conferir.

Devolva o espaço ao macOS

Depois do prune, confira o tamanho real de novo.

du -sh ~/Library/Containers/com.docker.docker/Data/vms/0/data/Docker.raw

Se ainda estiver enorme, abra o Docker Desktop, vá em Settings › Resources e reduza o Virtual disk limit, ou escolha Troubleshoot › Clean / Purge data para começar do zero. A segunda opção apaga todas as suas imagens, contêineres e volumes. Não arraste o Docker.raw para a Lixeira com o Docker em execução: você perde tudo o que está dentro dele e pode corromper a VM.

OrbStack, Colima e Podman

Os mesmos comandos funcionam, porque todos falam a API do Docker. O que muda é onde o disco fica.

• O OrbStack encolhe o disco automaticamente e usa espaço conforme a necessidade. Os dados ficam em ~/.orbstack. Veja os Settings do app e use docker system df como acima.
• O Colima guarda o disco em ~/.colima. O tamanho é definido quando você cria a instância com colima start --disk 100. colima delete remove a VM inteira.
• O Podman usa podman system df e podman system prune, com a imagem da máquina em ~/.local/share/containers/podman/machine.

Se você não usa mais o Docker, veja como desinstalar o Docker no Mac. Para uma visão mais ampla do resto das suas ferramentas, há a limpeza de disco para desenvolvedores.

Como o Levo faz isso

O Levo lista imagens do Docker e cache de build como tipos próprios em Ready to free, com tamanhos e motivos. Ele os encontra pelo índice ao vivo do seu disco, então você os vê sem rodar nenhum comando e sem precisar lembrar qual dos quatro comandos prune usar.

Seu agente avalia o que é seguro. Imagens que ninguém usa e cache de build são candidatos comuns. Volumes podem guardar dados que você não recupera, então confira esses você mesmo, e o Levo nunca limpa nada que esteja em uso. O agente só lê, e o Levo faz a exclusão depois de verificar de novo.

Você escolhe um nível de limpeza, marca o que vai embora e clica em Clean up. Se você desinstalar o Docker Desktop com o Levo, a etapa de confirmação lista as grandes sobras para você vê-las antes de irem. Veja Levo para desenvolvedores web. Duas limpezas são grátis, depois há uma licença vitalícia.

Perguntas frequentes

É seguro rodar docker system prune?

Sim, para contêineres, redes, imagens dangling e cache de build, mas o próximo build será mais lento e algumas imagens serão baixadas de novo. Ele não mexe nos volumes, a menos que você adicione --volumes, que é a opção que exige cuidado.

Por que o Docker.raw continua enorme depois que apaguei as imagens?

O arquivo é esparso e nem sempre encolhe quando o espaço dentro da VM é liberado. Confira o tamanho real com du -sh. Se ainda estiver grande, reduza o limite do disco virtual nos ajustes de Resources do Docker Desktop ou apague os dados dele.

Posso apagar o Docker.raw?

Só pelo menu Troubleshoot do Docker Desktop, com o Docker aberto, ou depois de fechá-lo e desinstalá-lo. Apagar o arquivo manualmente remove todas as imagens, contêineres e volumes que estão dentro dele.

Quanto espaço o Docker precisa no Mac?

Depende do que você roda. Reserve de 20 a 60 GB se você cria muitas imagens. O limite do disco virtual no Docker Desktop define o teto.

O OrbStack usa menos disco que o Docker Desktop?

Em geral sim, porque ele cresce e encolhe conforme a necessidade e compartilha arquivos com o macOS. Mesmo assim ele guarda imagens, cache de build e volumes, então docker system df e prune valem lá também.