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 など | アプリケーションがエラーで終了した(ログに原因が出ていることが多い) |
| 125 | docker run自体が失敗した(オプションの誤りなど) |
| 126・127 | 指定したコマンドが実行できない・見つからない |
| 137 | SIGKILLで強制終了された(メモリ上限による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で複数のコンテナを動かす」で扱っています。
この記事の内容を練習できる課題
同じような状況を、ブラウザの練習用ターミナルで再現して試せます。本番のサーバーで慌てないよう、手順を一度なぞっておきましょう。
- 起動直後に止まるコンテナの原因を調べる(コンテナ(LPIC-3))
- コンテナの停止・再開・削除(コンテナ(LPIC-3))
- docker グループで、sudo なしで操作できるようにする(コンテナ(LPIC-3))
- コンテナの中に入って調べる(コンテナ(LPIC-3))
ほかの課題は、練習問題の一覧から選べます。