docker compose stopとdownの違いを図解——どちらを使うべきか
2分で読める
テック
最終更新:
docker compose stop と docker compose down は、どちらもコンテナを止めるコマンドですが、止め方が異なります。よく迷うのでまとめます。
注: Docker Compose V1 では
docker-compose（ハイフンあり）と書いていましたが、現在の標準は V2 のdocker compose（スペース区切り）です。V1 は2023年7月にサポート終了しています。
違いを一言で
| コマンド | コンテナ | ネットワーク | ボリューム |
|---|---|---|---|
docker compose stop | 停止（削除しない） | 残る | 残る |
docker compose down | 停止＋削除 | 削除 | 残る（-v で削除可） |
docker compose stop
docker compose stopコンテナを停止しますが、削除はしません。停止したコンテナは docker compose start で再起動できます。データはコンテナ内に保持されます。
いつ使う: 一時的に止めて、後でまた起動したいとき。
docker compose down
docker compose downコンテナを停止し、コンテナとネットワークを削除します。ボリュームはデフォルトで残ります。ボリュームも含めて削除するには -v オプションを使います。
docker compose down -v # ボリュームも削除いつ使う: 環境をクリーンにリセットしたいとき、または docker compose up で作った環境を完全に片付けたいとき。
まとめ
- 再起動前提の一時停止 →
docker compose stop - 環境ごとリセット →
docker compose down
開発中は stop を使い回し、CI/CDや環境の作り直しには down を使うのが基本的な使い分けです。
記事の更新をメールで受け取る
質問・リクエストを送る
記事についての質問や、取り上げてほしいテーマがあればお気軽にどうぞ。いただいた質問はブログ記事として回答し、Q&Aページで公開することがあります。