Dockerのコンテナが起動しない・すぐ止まる

docker run -dでコンテナを起動したのに、docker psに表示されない。コンテナが「すぐ止まる」ときは、止まる直前の出力と終了コードが、原因を教えてくれます。

どんな症状か

docker run -dでコンテナIDが表示されたのに、docker psの一覧にそのコンテナが無い、またはdocker runの時点でError response from daemonのエラーが表示される、という症状です。前者は「起動したがすぐ終了した」、後者は「起動そのものができなかった」状態で、調べる場所が異なります。

原因を切り分ける

ステップ1:終了したコンテナと終了コードを確認する

$ sudo docker ps -a
CONTAINER ID   IMAGE   COMMAND                  CREATED          STATUS                      PORTS   NAMES
2df32a032322   mysql   "docker-entrypoint.s…"   10 seconds ago   Exited (1) 9 seconds ago            db

docker psは起動中のコンテナだけを表示するため、止まったコンテナを見るには-aが必要です。STATUSの括弧の中が終了コードです。

終了コード意味
0正常に終了した(処理が終わったので止まった。常駐させたいなら、実行するコマンドの見直しが必要)
1 などアプリケーションがエラーで終了した(ログに原因が出ていることが多い)
125docker run自体が失敗した(オプションの誤りなど)
126・127指定したコマンドが実行できない・見つからない
137SIGKILLで強制終了された(メモリ上限によるOOM、またはdocker kill)

ステップ2:止まる直前のログを確認する

$ sudo docker logs db
2026-11-16T11:01:04.722+00:00 [ERROR] [Entrypoint]: Database is uninitialized and password option is not specified
    You need to specify one of the following as an environment variable:
    - MYSQL_ROOT_PASSWORD
    - MYSQL_ALLOW_EMPTY_PASSWORD
    - MYSQL_RANDOM_ROOT_PASSWORD

コンテナは、止まったあとでもdocker logsで出力を確認できます。この例では、MySQLのイメージに必要な環境変数を指定していないことが原因だと分かります。

ステップ3:OOMで強制終了されていないか確認する

$ sudo docker inspect -f '{{.State.ExitCode}} {{.State.OOMKilled}}' db
1 false

終了コードが137で、OOMKilledがtrueなら、-mで指定したメモリ上限を超えて強制終了されています。上限を引き上げるか、アプリケーションのメモリの設定を見直します。

ステップ4:起動そのものができない場合のエラーを読む

  • port is already allocated:ホスト側のポートを、ほかのコンテナやプロセスが使っています。sudo ss -tlnpで確認し、別のポートで公開します。
  • Conflict. The container name "/web" is already in use:同じ名前のコンテナが残っています。docker rmで削除してから作り直します。
  • pull access denied・manifest unknown:イメージ名やタグの書き間違いです。
  • permission denied while trying to connect to the Docker daemon socket:dockerグループに入っていないか、sudoを付け忘れています。

解決方法

  • アプリケーションのエラーの場合:
    ログの指示どおりに、環境変数・設定ファイル・ボリュームを見直して、コンテナを作り直します(docker rmしてからdocker run)。
  • 終了コード0ですぐ止まる場合:
    コンテナはメインのプロセスが終わると止まります。
    bashだけを実行するイメージは-itを付けないとすぐ終了するため、常駐させるプロセスを指定します。
  • OOMの場合:
    docker update -mでメモリ上限を変更するか、作り直すときに-mの値を見直します。

再発を防ぐために

コンテナの起動に必要な環境変数やポートは、Docker Composeのcompose.yamlにまとめて記録しておくと、作り直すたびに指定を忘れる事故を防げます。--restart unless-stoppedを付けておくと、一時的なエラーで止まったときやホストの再起動後に、自動で起動し直します。

試してみよう:
この手順は、練習用ターミナルの課題「起動直後に止まるコンテナの原因を調べる」で実際に試せます。
Dockerの基本はDocker入門、Composeは「Docker Composeで複数のコンテナを動かす」で扱っています。

この記事の内容を練習できる課題

同じような状況を、ブラウザの練習用ターミナルで再現して試せます。本番のサーバーで慌てないよう、手順を一度なぞっておきましょう。

ほかの課題は、練習問題の一覧から選べます。