Conteúdo

Comando docker rmi: remova imagens e tags (-f, image prune)

Q: docker rmi e docker image rm são comandos diferentes?

Não. docker rmi, docker image rm e docker image remove são aliases do mesmo comando.

Q: Qual é a diferença entre docker image prune e docker image prune -a?

Sem -a, somente imagens dangling são removidas; com -a, todas as imagens que não estão sendo usadas por contêineres são removidas. Nos testes com Docker 29, o prune padrão recuperou 0B, enquanto -a removeu imagens não utilizadas.

Q: Depois de remover com -f uma imagem usada por um contêiner, ainda posso liberar o espaço dela?

Com docker system df -v, você pode ver que a imagem permanece com a tag ; nos testes, docker system prune -f a removeu e recuperou 147.6MB.

docker rmi (alias docker image rm) remove tags de imagens ou imagens não utilizadas; quando um contêiner usa uma imagem, normalmente ocorre um conflito. Para saber como limpar imagens e espaço em disco, consulte Limpar espaço em disco.

Sintaxe

docker rmi [opções] imagem [imagem...]
docker image rm [opções] imagem [imagem...]

Opções

Opção	Descrição
`-f, --force`	Força a remoção da imagem
`--no-prune`	Não remove imagens pai sem tags
`--platform string`	Remove somente a variante da plataforma especificada, por exemplo, `linux/amd64`

Opções de docker image prune:

Opção	Descrição
`-a, --all`	Remove todas as imagens não utilizadas, e não somente as imagens dangling
`--filter condição`	Define um filtro, por exemplo, `until=<timestamp>`
`-f, --force`	Não solicita confirmação

Exemplos

Os exemplos a seguir usam as imagens alpine, demo/app, redis e registry. Algumas tags apontam para o mesmo ID de imagem.

Remover uma tag e encontrar um conflito

$ docker images
IMAGE                                                                            ID             DISK USAGE   CONTENT SIZE   EXTRA
alpine:3.23                                                                      ff7f0c727dd7       26.6MB         8.21MB        
alpine@sha256:85fe1e81d6758c208f3e1eed4338a1997e19d4be002d4dd32d3100c9a8c010a0   85fe1e81d675         13MB         3.94MB        
demo/app:1.0                                                                     ff7f0c727dd7       26.6MB         8.21MB        
demo/app:2.0                                                                     ff7f0c727dd7       26.6MB         8.21MB        
localhost:5000/tools/alpine:3.23                                                 ff7f0c727dd7       26.6MB         8.21MB        
localhost:5000/tools/alpine:latest                                               ff7f0c727dd7       26.6MB         8.21MB        
redis:8-alpine                                                                   0bf6577d7774        161MB         39.6MB   U    
registry:3                                                                       01cd312e6702       86.9MB         20.7MB   U    

$ docker rmi demo/app:1.0
Untagged: demo/app:1.0

$ docker rmi redis:8-alpine
Error response from daemon: conflict: unable to delete redis:8-alpine (must be forced) - container 0663b06bc225 is using its referenced image 0bf6577d7774

Após remover demo/app:1.0, o Docker informa Untagged, porque o mesmo ID de imagem ainda tem outras tags.
redis:8-alpine está sendo usada por um contêiner. Se tentar removê-la diretamente, você receberá um conflito que também informa os IDs do contêiner e da imagem.
O U na coluna EXTRA indica que a imagem está em uso.

Forçar a remoção de uma tag com `-f`

$ docker rmi -f redis:8-alpine
Untagged: redis:8-alpine

$ docker ps -a --filter name=uses-redis
CONTAINER ID   IMAGE          COMMAND                  CREATED         STATUS         PORTS      NAMES
0663b06bc225   0bf6577d7774   "docker-entrypoint.s…"   3 seconds ago   Up 3 seconds   6379/tcp   uses-redis

$ docker rmi nosuch:image
Error response from daemon: No such image: nosuch:image

-f removeu a tag redis:8-alpine com sucesso. O contêiner listado em seguida continua em execução, mostrando que forçar a remoção da tag não interrompe o contêiner.
Se você tentar remover o nome de uma imagem inexistente, receberá No such image.
Depois da remoção forçada, a imagem pode permanecer localmente com a tag <none>. Use docker system df -v para consultar o uso detalhado.

Remover imagens dangling e todas as imagens não utilizadas

$ docker image prune -f
Total reclaimed space: 0B

$ docker image prune -a -f
Deleted Images:
untagged: alpine:3.23
untagged: alpine@sha256:85fe1e81d6758c208f3e1eed4338a1997e19d4be002d4dd32d3100c9a8c010a0
deleted: sha256:85fe1e81d6758c208f3e1eed4338a1997e19d4be002d4dd32d3100c9a8c010a0
deleted: sha256:1f3591b8a02ea153f41c5bba878ad477f63ab3d19349762cb77504db02a23e15
deleted: sha256:c3709935ef4cf35769588b317a43fa75b70a7ee51af2d449069ba66e956a0f44
untagged: localhost:5000/tools/alpine:3.23
untagged: localhost:5000/tools/alpine:latest
untagged: demo/app:2.0
deleted: sha256:ff7f0c727dd796aa36787bfcd9a64bf35a6ce72a73451b3359fde849b6703d63
deleted: sha256:3d67941fed5ae436b2bb9791cb3f50a252441c7706bbc5b4e738936df8ff8306
deleted: sha256:74a5b9d36e2dbe5329330986093322eb7619d9d5ebbc916392cf686d0e7381ce
deleted: sha256:8793abc479381bafd16c9d538b01c5a8dd7eef6aa10a737f2ad828ac73cb80e9
deleted: sha256:6d423cc7d2471ec6b5d77eaa820bc0808c1213c56c6fb88ccab237a486ecab64

Total reclaimed space: 26.7MB

$ docker images
IMAGE        ID             DISK USAGE   CONTENT SIZE   EXTRA
registry:3   01cd312e6702       86.9MB         20.7MB   U

Sem -a, image prune remove somente imagens dangling. Neste teste, não havia nenhuma imagem para limpar, então foram recuperados 0B.
Com -a, todas as imagens não utilizadas por contêineres são removidas, inclusive as que ainda têm tags. A imagem registry:3, que continua em uso, permanece.
No Docker 29, normalmente restam menos imagens dangling; por isso, um image prune comum muitas vezes não recupera espaço. Para remover todas as imagens não utilizadas, use -a.

Ver imagens `<none>` e limpar com system prune

$ docker system df -v | head -20
Images space usage:

REPOSITORY   TAG           IMAGE ID       CREATED         SIZE      SHARED SIZE   UNIQUE SIZE   CONTAINERS
myweb        snapshot      56e3f92534ca   7 seconds ago   92.1MB    0B            92.08MB       0
nginx        1.30-alpine   47928bf67eb6   3 days ago      93.5MB    12.94MB       80.6MB        1
registry     3             01cd312e6702   3 days ago      86.9MB    12.94MB       73.93MB       1
<none>       <none>        0bf6577d7774   3 days ago      161MB     12.93MB       147.6MB       0
alpine       3.23          ff7f0c727dd7   3 days ago      13MB      12.93MB       86.86kB       1

Containers space usage:

CONTAINER ID   IMAGE               COMMAND                  LOCAL VOLUMES   SIZE      CREATED          STATUS          NAMES
0c009f73010b   alpine:3.23         "sleep 600"              0               4.1kB     42 seconds ago   Up 41 seconds   small
63b9a2f9c63f   nginx:1.30-alpine   "/docker-entrypoint.…"   0               115kB     44 seconds ago   Up 43 seconds   web
35357aad74b1   registry:3          "/entrypoint.sh /etc…"   1               20.5kB    2 minutes ago    Up 2 minutes    registry

Local Volumes space usage:

VOLUME NAME                                                        LINKS     SIZE
21ea99090ddead0461eb5a6efd670e1d9cf58fe9c23d5f8618db5868fb6170aa   1         3.854MB

$ docker system prune -f
Deleted Images:
untagged: sha256:0bf6577d7774e592b29d093e3ac9390eb91e13d72c21e506afce736de5e0eeb0
deleted: sha256:0bf6577d7774e592b29d093e3ac9390eb91e13d72c21e506afce736de5e0eeb0
deleted: sha256:16b124a2d3eacd620d917ead6fd26cbf1f1d7117fa94122398971931cfe2d403
deleted: sha256:f79a7876c6644b273e4eec899344e51c66959237a2f71188db8cb98d7311521c

Total reclaimed space: 147.6MB

$ docker system df
TYPE            TOTAL     ACTIVE    SIZE      RECLAIMABLE
Images          4         3         272.6MB   92.08MB (33%)
Containers      3         3         139.3kB   0B (0%)
Local Volumes   1         1         3.854MB   0B (0%)
Build Cache     0         0         0B        0B

docker system df -v mostra a imagem <none>:<none> com o ID 0bf6577d7774. Nenhum contêiner a usa, mas ela ainda ocupa 161MB, dos quais 147.6MB são espaço exclusivo.
docker system prune -f removeu essa imagem e os dados relacionados, recuperando 147.6MB. Depois disso, o uso de Images caiu de 420.2MB para 272.6MB.
system prune limpa outros dados não utilizados do Docker. Se você quiser cuidar somente das imagens, use docker image prune.

Capítulos relacionados

Exercícios

Exercício: tente primeiro remover redis:8-alpine; em seguida, use -f para remover sua tag e confirme que o contêiner uses-redis, que usa essa imagem, continua em execução.

Resposta

docker rmi redis:8-alpine
docker rmi -f redis:8-alpine
docker ps -a --filter name=uses-redis

Perguntas frequentes

`docker rmi` e `docker image rm` são comandos diferentes?

Não. docker rmi, docker image rm e docker image remove são aliases do mesmo comando.

Posso remover diretamente uma imagem usada por um contêiner em execução?

A remoção normal retorna um conflito e informa qual contêiner está usando a imagem. Com -f, você pode remover a tag da imagem; nos testes, o contêiner continuou em execução.

Qual é a diferença entre `docker image prune` e `docker image prune -a`?

Sem -a, somente imagens dangling são removidas; com -a, todas as imagens que não estão sendo usadas por contêineres são removidas. Nos testes com Docker 29, o prune padrão recuperou 0B, enquanto -a removeu imagens não utilizadas.

Depois de remover com `-f` uma imagem usada por um contêiner, ainda posso liberar o espaço dela?

Com docker system df -v, você pode ver que a imagem permanece com a tag <none>; nos testes, docker system prune -f a removeu e recuperou 147.6MB.

Atualizado 26 de outubro de 2026