できない.dev

Docker rmi「image is being used by stopped container」の原因と直し方

image is being used by stopped container は、停止中のコンテナがイメージを参照していると出る。
先に docker rm でコンテナを消すか、docker rmi -f で強制削除すれば直る。

公開: 更新:

症状できない · exit 1
docker rmi rmi-demo:latest
Error response from daemon: conflict: unable to delete rmi-demo:latest (must be forced) - container 2a1e58b1eff3 is using its referenced image 4928695c073f
解決後できた · exit 0
docker rmi rmi-demo:latest
Untagged: rmi-demo:latest
Deleted: sha256:4928695c073fd1ba1e8a787053a390c4cbccdde9ffb8f7b8506ed30bab5eec9b

2026-08-26 に local host (Windows 11 Home, Docker 29.1.3)(Docker 29.1.3 / Node.js 22.14.0) で実際に打って取った出力。検証環境の詳細

要約

Error response from daemon: conflict: unable to delete <id> (must be forced) - image is being used by stopped container <cid> の本質は、参照しているコンテナがまだ存在する ことにある。
コンテナを docker rm で消してから docker rmi、もしくは docker rmi -f で強制削除する。

containerd イメージストアを使う環境では、同じ状況で conflict: unable to delete <image> (must be forced) - container <cid> is using its referenced image <id> と出る(下の実行例)。
対処は同じである。

実行例

イメージを一度 docker run した後に docker rmi すると、conflict: unable to delete rmi-demo:latest (must be forced) - container 2a1e58b1eff3 is using its referenced image が返り、終了コードは 1 だった。
docker ps -a --filter ancestor= で参照元をたどると、Exited のコンテナが 1 つ残っていた。
それを docker rm してから同じ docker rmi を打つと、Untagged と Deleted が出て終了コード 0 で消えた。

$ docker build --progress=plain --no-cache -t rmi-demo:latest .
#0 building with "desktop-linux" instance using docker driver
 
#1 [internal] load build definition from Dockerfile
#1 transferring dockerfile: 77B done
#1 DONE 0.0s
 
#2 [internal] load metadata for docker.io/library/alpine:3
#2 DONE 0.0s
 
#3 [internal] load .dockerignore
#3 transferring context: 2B done
#3 DONE 0.0s
 
#4 [1/2] FROM docker.io/library/alpine:3@sha256:28bd5fe8b56d1bd048e5babf5b10710ebe0bae67db86916198a6eec434943f8b
#4 resolve docker.io/library/alpine:3@sha256:28bd5fe8b56d1bd048e5babf5b10710ebe0bae67db86916198a6eec434943f8b 0.0s done
#4 DONE 0.0s
 
#4 [1/2] FROM docker.io/library/alpine:3@sha256:28bd5fe8b56d1bd048e5babf5b10710ebe0bae67db86916198a6eec434943f8b
#4 CACHED
 
#5 [2/2] RUN echo demo > /demo.txt
#5 DONE 0.2s
 
#6 exporting to image
#6 exporting layers 0.0s done
#6 exporting manifest sha256:b1557b2419c8b464d9a55b48223c69dfc28b67abb3de97e82ec396d0828c6e51 done
#6 exporting config sha256:b7a7d0499c5c44fb4502b12a7ba497e8e2621ac99ce12e1573d98abf0fc9728b done
#6 exporting attestation manifest sha256:ac6b42ce772aa84cca03cb56082c460fa47d2782fa77269cf2e16debe70a53fd 0.0s done
#6 exporting manifest list sha256:4928695c073fd1ba1e8a787053a390c4cbccdde9ffb8f7b8506ed30bab5eec9b done
#6 naming to docker.io/library/rmi-demo:latest done
#6 unpacking to docker.io/library/rmi-demo:latest 0.0s done
#6 DONE 0.1s
$ docker run --name rmi-demo-c rmi-demo:latest cat /demo.txt
demo
$ docker rmi rmi-demo:latest
Error response from daemon: conflict: unable to delete rmi-demo:latest (must be forced) - container 2a1e58b1eff3 is using its referenced image 4928695c073f
$ echo $?
1
$ docker ps -a --filter ancestor=rmi-demo:latest
CONTAINER ID   IMAGE             COMMAND           CREATED         STATUS                              PORTS     NAMES
2a1e58b1eff3   rmi-demo:latest   "cat /demo.txt"   2 seconds ago   Exited (0) Less than a second ago             rmi-demo-c
$ docker rm rmi-demo-c
rmi-demo-c
$ docker rmi rmi-demo:latest
Untagged: rmi-demo:latest
Deleted: sha256:4928695c073fd1ba1e8a787053a390c4cbccdde9ffb8f7b8506ed30bab5eec9b
$ echo $?
0

— 2026-08-26 時点の出力

検証環境Node.js 22.14.0 / npm 10.9.2 / Git 2.48.1.windows.1 / 2026-08-26 検証(ほか 1 件)
検証日
実行環境
local host (Windows 11 Home, Docker 29.1.3)
バージョン
  • Node.js 22.14.0
  • npm 10.9.2
  • Git 2.48.1.windows.1
  • Docker 29.1.3

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. 参照中コンテナを特定して削除

docker ps -a --filter ancestor=<image-name-or-id>
docker rm <container-id>
docker rmi <image-name-or-id>

-a を付けて、停止コンテナまで列挙するところが肝心である。

2. 強制削除(-f)

docker rmi -f <image-name-or-id>

-f はタグを外すだけで、コンテナが参照中の共有レイヤ自体は残る。
実体は消えないので「容量が戻らない」と感じることがある(公式 docker image rm(新しいタブで開く) 参照)。

3. 複数タグを確認して全削除

docker image inspect <image> --format '{{.RepoTags}}'
docker rmi app:latest app:v1

タグごとに削除しないと、最後のタグが消えるまで実体は残る。

4. Compose の一括クリーンアップ

docker compose down --rmi all --volumes

サービスコンテナ・ネットワーク・関連イメージ・volume をまとめて消す。
docker compose down だけだとイメージは残る。

5. 未使用全体を掃除

docker system prune -a --volumes

-a は未使用イメージも対象にし、--volumes は匿名 volume まで掃除する。
CI のディスク逼迫対策にも有効である(docker system prune 公式(新しいタブで開く))。

よくある原因

  1. 停止したコンテナが残っている。
    docker stop しただけで docker rm していない。
    停止コンテナもイメージを参照する。
  2. 複数のタグが付いている。
    1 つの image ID に app:latest と app:v1 のように複数タグが付き、一方から参照が残る。
  3. 派生イメージがある。
    従来のイメージストアでレガシービルダー(DOCKER_BUILDKIT=0)を使い、FROM で子イメージを作ると、親を ID で消すときに image has dependent child images で止まり、-f でも消せない。
    BuildKit で作ったイメージや containerd イメージストアでは止まらない。
  4. Compose の残骸がある。
    docker compose down を呼ばずに stop で終え、サービスコンテナが残っている。