MongoDBをDockerで動かすときは、公式イメージ mongo のタグを固定し、データを名前付きボリュームに置き、環境変数でrootユーザーを作る、の3点が出発点です。この記事では2026年11月時点の9.0系を前提に、docker runの最小構成、compose.yamlでの認証・永続化・ヘルスチェック、docker-entrypoint-initdb.dによるアプリ用ユーザーの作成を順に示します。後半では、トランザクションのための単一ノードのレプリカセット化とkeyFile、mongodumpでの退避、8.0系からの更新手順、そして本番でもコンテナで動かしてよい条件を扱います。
まとめ:MongoDBをDockerで動かす前に決めるイメージ・保存先・認証の結論
開発・検証用なら、Docker Hubの mongo:9.0 を使い、/data/db に名前付きボリュームを割り当て、ポートは 127.0.0.1 にだけ公開します。rootユーザーは MONGO_INITDB_ROOT_USERNAME と MONGO_INITDB_ROOT_PASSWORD の両方を渡したときだけ作られ、そのとき認証も有効になります。アプリ用のユーザーやインデックスは初期化スクリプトで作りますが、スクリプトが動くのはデータディレクトリが空の初回だけです。
トランザクションやchange streamsを試すなら、1台でもレプリカセットとして起動します。認証と併用する場合はkeyFileが必要になり、権限と所有者で詰まりやすい箇所です。本番に使うかどうかは、可用性の要件とDB運用の担当者がいるかで決めます。自動フェイルオーバーが要るなら1台構成のコンテナは選ばず、3ノードのレプリカセットかマネージドサービスにします。
MongoDBのDockerイメージ選定:公式mongoとMongoDB社の違い
公式mongoとMongoDB社イメージの保守元・ベースOS・タグ形式
MongoDBのコンテナイメージは2系統あります。1つはDocker HubのDocker Official Images「mongo」で、Dockerfileと起動スクリプトはGitHubのdocker-library/mongoで公開されています。もう1つは、MongoDB社のInstall MongoDB Community on Dockerが案内する mongodb/mongodb-community-server で、例のタグは 9.0-ubi9-slim です。
| 観点 | mongo | MongoDB社イメージ |
|---|---|---|
| ベースOS | Ubuntu resolute | UBI 9 slim |
| タグの例 | 9.0.8・9.0 | 9.0-ubi9-slim |
| rootユーザー作成 | 環境変数で可 | 手順に記載なし |
| 初期化スクリプト | 対応 | 手順に記載なし |
この記事では、初期化スクリプトと環境変数の仕組みがソースで確かめられる mongo を使います。MongoDB社のイメージでも5.0以降はCPUのAVX対応が必要で、7.0より前の版はサポート終了と公式ページに明記されています。
2026年11月のタグ選定:latestを避けて9.0系に固定する理由
Docker Hubのタグ一覧では、2026年11月12日に 9.0.8・8.3.17・8.0.38・7.0.48 が同時に更新されました。latest は9.0.8を指していますが、10.0系が出た時点で切り替わります。メジャー版の更新はFCV(featureCompatibilityVersion)の手順を伴うため、compose.yamlには mongo:9.0 のようにメジャー版まで書いておきます。
パッチ版まで固定する mongo:9.0.8 は再現性が高い一方、セキュリティ修正の取り込みを手で追う必要があります。2025年のMongoBleed(CVE-2025-14847の影響バージョンと確認手順)のように修正版の適用を急ぐ場面があるので、開発環境は 9.0、本番寄りの環境はパッチ版固定と定期更新、と分けるのが扱いやすい形です。
docker runで1台起動して、mongoshで接続と書き込みを確かめる手順
docker runの最小構成:名前付きボリュームとlocalhost限定のポート公開
まず1台だけ起動します。Docker Desktopの導入とライセンス条件はDocker Desktopのライセンスと導入手順で整理しています。次の例はbashやzshでの書き方です。
docker volume create mongo-data
docker run -d --name mongo \
-p 127.0.0.1:27017:27017 \
-v mongo-data:/data/db \
-e MONGO_INITDB_ROOT_USERNAME=root \
-e MONGO_INITDB_ROOT_PASSWORD=change-me-now \
mongo:9.0
-p 127.0.0.1:27017:27017 の 127.0.0.1 を省くと、ホストの全インターフェースで27017番が開きます。公式イメージは既定で認証が無効なので、rootユーザーの環境変数を付け忘れたまま全公開すると、誰でも読み書きできるDBになります。
イメージ側は 9.0のDockerfile で VOLUME /data/db /data/configdb を宣言しています。-v を書かなくても匿名ボリュームは作られますが、名前が無いため docker rm のあとで取り違えやすく、明示しておく方が安全です。
コンテナ内のmongoshで接続・疎通・書き込み・検索を確認する手順
公式イメージにはシェルとDatabase Toolsが同梱されているので、ホストにmongoshを入れなくても確認できます。-p の後ろに値を書かなければ、パスワードは対話で入力します。
docker exec -it mongo mongosh -u root -p --authenticationDatabase admin
use shop
db.adminCommand({ ping: 1 })
db.items.insertOne({ sku: "A-001", qty: 3 })
db.items.find()
use shop の時点ではデータベースはまだ作られず、最初の insertOne で作成されます。GUIで中身を見たい場合は、MongoDB Compassの接続とクエリの手順のとおり 127.0.0.1:27017 に authSource=admin を付けて繋ぎます。
compose.yamlでMongoDBを定義する:認証・永続化・ヘルスチェックの全体
compose.yamlの全体像と.envに分けるrootユーザー名・パスワード
アプリと一緒に動かす場合の定義先はComposeです。Compose自体の考え方はdocker-composeとは、同じ型をPostgreSQLで組んだ例はDocker PostgreSQL構築の手順にあります。パスワードはcompose.yamlに直書きせず、同じフォルダの .env に置いてGitの管理から外します。
# .env(.gitignore に追加する)
MONGO_ROOT_USER=root
MONGO_ROOT_PASSWORD=change-me-root
APP_DB_PASSWORD=change-me-app
# compose.yaml
services:
mongo:
image: mongo:9.0
restart: unless-stopped
environment:
MONGO_INITDB_ROOT_USERNAME: ${MONGO_ROOT_USER}
MONGO_INITDB_ROOT_PASSWORD: ${MONGO_ROOT_PASSWORD}
MONGO_INITDB_DATABASE: shop
APP_DB_PASSWORD: ${APP_DB_PASSWORD}
ports:
- "127.0.0.1:27017:27017"
volumes:
- mongo-data:/data/db
- ./initdb:/docker-entrypoint-initdb.d:ro
healthcheck:
test: ["CMD", "mongosh", "--quiet", "--eval", "db.adminCommand('ping').ok"]
interval: 10s
timeout: 5s
retries: 5
start_period: 20s
app:
build: .
environment:
MONGODB_URI: mongodb://app:${APP_DB_PASSWORD}@mongo:27017/shop?authSource=shop
depends_on:
mongo:
condition: service_healthy
volumes:
mongo-data:
Docker Hubの説明では、_FILE を末尾に付けてファイルから値を読む方式が使えるのは MONGO_INITDB_ROOT_USERNAME と MONGO_INITDB_ROOT_PASSWORD の2つだけです。環境変数の値は docker inspect で読めるので、共有サーバーではComposeのsecretsと _FILE の組み合わせに切り替えます。
Windows・Macの保存先:バインドマウントを避け名前付きボリュームへ
Docker Hubの説明には、WindowsとmacOSでLinuxベースのイメージを使う場合、ホストと共有するファイルシステムはMongoDBのメモリマップドファイルの使い方と互換性が無く、データディレクトリをホストのフォルダにマウントできない、と書かれています。./data:/data/db のようなバインドマウントは、Linuxのホストに限って使う書き方です。
退避は後述のmongodumpで行い、動作中のボリュームのファイルをコピーしてバックアップ代わりにする運用は避けます。
アプリの起動順を制御する:ヘルスチェック成功まで依存先の起動を待つ設定
depends_on を書くだけでは、MongoDBのコンテナが「起動した」時点でアプリが動き出し、接続に失敗します。Composeの起動順の説明にあるとおり、condition: service_healthy を付けるとhealthcheckが成功するまで依存先の起動を待ちます。
上のhealthcheckは ping コマンドを送るだけで、認証無しでも結果が返ります。初回起動では後述の初期化処理が先に走るため、start_period を20秒ほど取っておくと、初期化中の失敗が再試行回数に数えられません。
初期化スクリプトでアプリ用ユーザー・コレクション・インデックスを作る
初期化用.jsの配置と実行例:アプリ用ユーザーとインデックスを作成する
rootユーザーでアプリを繋ぐのは避け、対象DBにだけ権限を持つユーザーを作ります。initdb フォルダに次の .js を置くと、初回起動時に MONGO_INITDB_DATABASE で指定した shop に対してmongoshで実行されます。指定が無ければ対象は test です。
// initdb/01-app-user.js(MONGO_INITDB_DATABASE=shop に対して実行される)
db.createUser({
user: "app",
pwd: process.env.APP_DB_PASSWORD,
roles: [{ role: "readWrite", db: "shop" }]
});
db.createCollection("orders");
db.orders.createIndex({ customerId: 1, createdAt: -1 });
ユーザーは shop に作られるので、接続文字列の authSource も shop です。権限の指定方法はdb.createUser()のリファレンス、複合インデックスの並べ方はMongoDBのインデックス設計とESRの並び順で確認できます。.sh と .js はファイル名のアルファベット順に実行されるため、先頭に番号を付けておくと順序が読み取れます。
初期化が二度と走らない条件:WiredTigerファイルが残る限りスキップ
「initdbのスクリプトを直したのに反映されない」は、仕様どおりの動きです。9.0のdocker-entrypoint.shは、データディレクトリに WiredTiger・journal・local.0・storage.bson のどれかがあれば初期化をまるごと飛ばします。rootのパスワードを .env で変えても、既存データには効きません。
同じスクリプトを読むと、初期化は一時的なmongodを --bind_ip 127.0.0.1 で起動し、--auth を外した状態で実行してから停止する流れです。初期化の途中でコンテナの外から接続できないのはこのためです。
- 開発環境でやり直す:
docker compose down -vでボリュームごと消してから起動し直す - データを残したまま足す:ユーザーやインデックスはmongoshで直接作り、同じ内容を初期化スクリプトにも書き足す
- パスワードを変える:mongoshで
db.changeUserPassword()を実行し、そのあと.envを合わせる
down -v は本番相当の環境で打つとデータが消えます。手順書に書くときは、対象の環境名を必ず添えてください。
単一ノードのレプリカセットにする手順:トランザクションとchange streams用
認証なしの開発用レプリカセット:ヘルスチェックで初期化を1回だけ実行
Transactionsの公式ページは、複数ドキュメントのトランザクションの対象をレプリカセットとシャードクラスタとしています。単体のmongodのままでは、ORMのトランザクションやchange streamsのテストが通りません。開発用なら1台をレプリカセットとして起動すれば足ります。
services:
mongo:
image: mongo:9.0
command: ["--replSet", "rs0"]
ports: ["127.0.0.1:27017:27017"]
volumes: ["mongo-data:/data/db"]
healthcheck:
test: ["CMD", "mongosh", "--quiet", "--eval", "try { rs.status().ok } catch (e) { rs.initiate({ _id: 'rs0', members: [{ _id: 0, host: 'mongo:27017' }] }).ok }"]
interval: 5s
timeout: 10s
retries: 30
volumes:
mongo-data:
メンバーのホスト名に指定しているのはComposeのサービス名 mongo です。同じネットワークのアプリは replicaSet=rs0 で繋がり、ホストのPCからは名前が引けないため directConnection=true を付けて 127.0.0.1 に繋ぎます。3台に増やして選出を確かめる構成は、MongoDBレプリカセットの構築手順で扱っています。トランザクションの書き方はNoSQLのトランザクションの実装を参照してください。
認証ありで組むときはkeyFileが必須:権限400とmongodbユーザーの所有
rootユーザーの環境変数と --replSet を同時に使うと、レプリカセットのメンバー間認証が必要になります。Keyfile認証の公式手順は、鍵の長さを6〜1024文字のbase64文字、UNIXでは所有者以外に権限を与えないこと、と定めています。
openssl rand -base64 756 > mongo-keyfile
services:
mongo:
image: mongo:9.0
entrypoint:
- bash
- -c
- |
cp /run/mongo-keyfile-src /data/configdb/keyfile
chmod 400 /data/configdb/keyfile
exec docker-entrypoint.sh mongod --replSet rs0 --keyFile /data/configdb/keyfile
environment:
MONGO_INITDB_ROOT_USERNAME: ${MONGO_ROOT_USER}
MONGO_INITDB_ROOT_PASSWORD: ${MONGO_ROOT_PASSWORD}
ports: ["127.0.0.1:27017:27017"]
volumes:
- mongo-data:/data/db
- mongo-config:/data/configdb
- ./mongo-keyfile:/run/mongo-keyfile-src:ro
healthcheck:
test: ["CMD-SHELL", "mongosh -u \"$$MONGO_INITDB_ROOT_USERNAME\" -p \"$$MONGO_INITDB_ROOT_PASSWORD\" --authenticationDatabase admin --quiet --eval \"try { rs.status().ok } catch (e) { rs.initiate({ _id: 'rs0', members: [{ _id: 0, host: 'mongo:27017' }] }).ok }\""]
interval: 5s
timeout: 10s
retries: 30
volumes:
mongo-data:
mongo-config:
keyFileを直接マウントしないのは、所有者の問題を避けるためです。entrypointはrootで起動されたとき、/data/configdb と /data/db の配下をmongodbユーザー(UID 999)の所有に変えてから、gosuで権限を落とします。そこにコピーして chmod 400 を掛ければ、ホストがWindowsでも権限で起動が止まりません。初期化時の一時mongodからは --replSet と --keyFile が外されるため、rootユーザーの作成とレプリカセットの指定はぶつかりません。
公式手順は、keyFileを最小限の保護でテストや開発向けとし、本番ではX.509証明書を推奨しています。この構成をそのまま本番に持ち込むのは避けます。
バックアップ・バージョン更新・アプリ接続まわりで詰まる箇所と対処
mongodumpの–archiveと–gzipでコンテナからホストへ退避する
公式イメージにはmongodumpとmongorestoreが入っているので、docker exec で実行して標準出力をホストのファイルに受けます。mongodumpのリファレンスでは、--archive にファイル名を書かなければ標準出力へ書き、--gzip でその出力を圧縮します。
# 退避(bash で実行)
docker exec mongo sh -c 'mongodump -u "$MONGO_INITDB_ROOT_USERNAME" -p "$MONGO_INITDB_ROOT_PASSWORD" --authenticationDatabase admin --archive --gzip' > mongo-20261115.archive.gz
# 復元(既存のコレクションを消してから戻す)
docker exec -i mongo sh -c 'mongorestore -u "$MONGO_INITDB_ROOT_USERNAME" -p "$MONGO_INITDB_ROOT_PASSWORD" --authenticationDatabase admin --archive --gzip --drop' < mongo-20261115.archive.gz
単一ノードのレプリカセットで動かしているなら --oplog を足すと、ダンプ中の書き込みも取り込んで一時点の状態に揃えられます。復元側で使う --oplogReplay の指定は、mongorestoreのリファレンスが根拠です。退避ファイルは別のホストかストレージへ移し、月に1回は空の環境へ戻せるかを試しておきます。
8.0系から9.0系へ更新する手順:動作確認後にFCVを上げる順序
9.0へのアップグレード手順では、9.0へ上げられるのは8.3か8.0の系列からで、7.0系は先に8.0系へ上げる必要があります。コンテナではタグを1段ずつ書き換えて起動し直す形になります。
- mongodumpで退避し、現在のFCVを
db.adminCommand({ getParameter: 1, featureCompatibilityVersion: 1 })で確かめる - compose.yamlの
mongo:8.0をmongo:9.0に書き換え、docker compose up -dで入れ替える - アプリの動作を一定期間確認してから、FCVを9.0へ上げる
db.adminCommand({ setFeatureCompatibilityVersion: "9.0", confirm: true })
confirm: true を付けないとコマンドは失敗します。公式手順は、FCVを上げる前に新機能を有効にしない期間を置くよう勧めています。FCVを上げたあとは前の版へ戻す作業が重くなるので、手順3を急がないことが肝心です。
アプリから繋がらない4つの原因:ホスト名・authSource・bind_ip・初期化
接続エラーの原因は、次の4つでほぼ説明できます。上から順に疑うと早く片付きます。
- ホスト名:同じComposeのアプリからは
localhostでなくサービス名mongoで繋ぐ。localhostはアプリ自身のコンテナを指す - authSource:ユーザーを作ったDBと一致させる。初期化スクリプトで作ったappは
shop、rootはadmin - bind_ip:イメージは指定が無ければ
--bind_ip_allを足す。自前のmongod.confでnet.bindIp: 127.0.0.1を書くと、他のコンテナから届かない - 初期化の未実行:既存ボリュームのせいでappユーザーが作られていない。mongoshで
db.getUsers()を見て確かめる
認証エラーの多くはauthSourceの取り違えで、パスワード自体は合っています。ログに UserNotFound が出ていれば、ユーザーを探しに行ったDBが違うと判断できます。
Dockerで動かすMongoDBを本番に使う条件と、Atlasなどへ任せる場面
本番でもコンテナで動かす条件:単一ホストの社内システムと復旧手順の整備
1台のコンテナで本番を動かしてよいのは、停止が数時間許される社内システムで、mongodumpの定期実行と復元の練習が手順書になっている場合です。閉域網から出せないデータや、クラウドのマネージドサービスを契約できない事情があるときも、この構成が現実的な選択肢になります。
条件を満たすかどうかの線引き、レプリカセットへの移行、既存のRDBからのデータ移行まで含めて見直したい場合は、データベース設計・移行支援で構成と運用手順をまとめて設計できます。そもそもMongoDBが業務に向くかから判断したい段階なら、MongoDBの仕組みと向かない業務の判断基準が先です。
見送る場面:可用性要件がある・DB運用担当が不在・1台に全ノード同居
次のどれかに当てはまるなら、1台構成のコンテナは本番に使いません。
- 業務時間中の停止が許されない:ホストの障害がそのままサービス停止になる。3ノードのレプリカセットを別々のホストに置く
- パッチ適用・退避・復元を担う人がいない:MongoDB Atlasのクラスタ階層と料金を見積もり、運用ごと任せる方が安くつく
- 1台のホストにレプリカセットの3ノードを同居させる:冗長化に見えて、ホスト障害で全ノードが同時に落ちる
AWSに寄せたいなら、MongoDB互換のAmazon DocumentDBの仕組みと採用判断も比較に入ります。
MongoDBのDocker構築のよくある質問:ユーザー・GUI・データの場所
MongoDBをDockerで動かすときに出やすい質問をまとめました。
MONGO_INITDB_ROOT_USERNAMEを設定したのにユーザーが作られないのはなぜですか?
原因は2つに絞れます。1つはパスワードの変数を渡していないことで、ユーザー名とパスワードの両方がそろったときだけrootユーザーが作られます。もう1つは、既存のボリュームを使っていることです。データディレクトリにWiredTigerのファイルが残っていると、初期化処理はまるごと飛ばされます。開発環境なら docker compose down -v でボリュームを消して起動し直し、データを残したい環境ならmongoshでユーザーを作ります。
mongo-expressなどのGUIツールもコンテナで動かすべきですか?
開発環境で中身を眺めるだけなら、ホストのMongoDB Compassから 127.0.0.1:27017 へ繋ぐ方法で足ります。mongo-expressをComposeに足すとブラウザから操作できますが、管理画面のポートを社内LANへ公開すると、DBの読み書きをWeb画面越しに許すことになります。追加する場合も、ポートは 127.0.0.1 に限定し、認証情報を必ず設定してください。
Dockerのコンテナを削除するとMongoDBのデータは消えますか?
docker rm や docker compose down では、名前付きボリュームは消えません。次に同じボリュームを指定して起動すれば、データはそのまま戻ります。消えるのは docker compose down -v や docker volume rm を実行したときです。-v を付けずに起動した場合も匿名ボリュームに保存されていますが、どのボリュームか分かりにくくなるため、名前を付けて運用してください。
Apple シリコンのMacやARMのサーバーでも公式イメージは動きますか?
Docker Hubの mongo イメージは、amd64とarm64v8の両方に対応しています。Apple シリコンのMacやAWS Gravitonのサーバーでも、同じ mongo:9.0 のタグで対応するアーキテクチャのイメージが取得されます。x86の古いCPUで起動しない場合は、5.0以降がAVX対応を求める点を疑ってください。
ホストにmongoshやmongodumpを入れる必要はありますか?
必須ではありません。9.0の公式イメージはシェルとDatabase Toolsのパッケージを同梱しており、docker exec でコンテナ内のmongoshやmongodumpを使えます。ホストに入れるのは、CIのジョブから直接繋ぎたい場合や、退避ファイルを別のサーバーで扱う場合です。
関連記事
- MongoDBとは?ドキュメント指向データベースの仕組み・利点・使い方入門:MongoDBを採用するかの判断から読みたい場合
- MongoDBレプリカセットの構築手順:rs.initiateからフェイルオーバー確認まで:Docker Composeで3ノードを組む次の段階
- Docker PostgreSQL構築の手順:compose定義とinitdb初期化:同じ型をPostgreSQLで組む場合
- docker-composeとは?複数コンテナをymlで定義し一括管理する仕組み:compose.yamlの書き方の基礎
- MongoDB Atlasとは?クラスタ階層・料金・セキュリティ設定と採用判断:自前の運用をやめて任せる場合の選択肢