1先に、つまずく4か所
p4ssw0rdstable/15〜17 すべて同じ。上書き前提の設計ですが、変えないまま運用しないこと2インストール方法は5つ。公式の推奨はDocker
公式ドキュメントは次の5つを挙げ、「We recommend using the Docker installation.」と明記しています。
- Docker Compose — 「Recommended setup for OpenProject in an isolated manner using Docker Compose」
- DEB/RPM パッケージ — 「limited supported distributions」(対応ディストリビューションは限られる)
- 単一Dockerコンテナ
- Helm チャート
- その他(Kubernetes 等)
公式に「今後の機能の一部はDocker版でしか提供しない予定」「Ubuntu 24.04のような新しいLinux向けのパッケージを提供する予定はない」と書かれています。新規に建てるならDocker版一択と考えてよいでしょう。
3サーバーの大きさ
規模が大きくなった場合の目安も公式に載っています(ガイドラインであり、実際の監視結果に合わせて調整することと明記されています)。
| 規模 | データベース | アプリ側CPU | ディスク |
|---|---|---|---|
| 小 | 2 CPU / 4 GiB RAM | 2 CPU | 20 GB+添付分 |
| 中 | 2〜4 CPU / 8 GiB RAM | 4 CPU | 50 GB+添付分 |
| 大 | 4〜8 CPU / 16 GiB RAM | 8 CPU | 100 GB+添付分 |
| 〜500ユーザーあたり | 2 CPU / 8 GiB RAM | 4〜6 CPU | +20〜50 GB |
4データベース ─ ここが最大の分岐点
OpenProject は実質 PostgreSQL 専用です。公式のシステム要件に挙がっているのは PostgreSQL だけで、MySQL の記載はありません。そして公式の導入FAQには、はっきりこう書かれています。
「OpenProject has traditionally supported both MySQL and PostgreSQL, but in order to optimize for performance and SQL functionality, it is unfeasible to support both DBMS…」
「This led us to the path of removing support in the upcoming stable releases of OpenProject…」
OpenProject 公式ドキュメント Installation FAQ「Can I use MySQL instead of PostgreSQL?」より
既存のMySQL環境からは pgloader を使ってPostgreSQLへ移行する手順が公式に案内されています。「MySQLでも動くだろう」で計画を立てないでください。
OpenProject 16.0.0 以降、公式サポートは PostgreSQL 16 以上。13〜15については「公式サポート対象外だが動作する可能性はある。ただし非互換や性能劣化を招きうる」と明記されています。
あわせて拡張が3つ必要です:pg_trgm(あいまい検索)/btree_gist/unaccent(ダイアクリティカルマーク除去)。マネージドDBを使う場合、これらの拡張が有効化できるかを先に確認してください。
5公式composeをそのまま使ってはいけない2点
本番向けの構成は opf/openproject-docker-compose リポジトリの stable/<メジャー> ブランチにあります(OpenProject本体のリポジトリ直下にある docker-compose.yml は開発用で、openproject/dev:latest を使っています。間違えないでください)。
# 本番用はこちら(メジャーごとにブランチが分かれている)
git clone --branch stable/17 https://github.com/opf/openproject-docker-compose
# 開発用(本番に使わない)
# https://github.com/opf/openproject/blob/dev/docker-compose.yml ← openproject/dev:latest
p4ssw0rd のまま.env で上書きする
stable/15・16・17 のいずれも POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-p4ssw0rd} です。これは環境変数で上書きする前提の設計で、db サービスは backend ネットワークのみに接続されホストにポート公開されていません(外部に開いているのは proxy の ${PORT:-8080}:80 だけ)。ただちに侵入されるものではありませんが、既定値のまま運用する理由はありません。
13 のまま16 以上を明示する
公式composeは image: postgres:${POSTGRES_VERSION:-13} です。一方で公式のシステム要件は16以上を公式サポート、13〜15は対象外と書いています。既定のまま立てると、同じプロジェクトの要件が「非公式」と呼ぶ構成になります。新規構築なら最初から16以上にしてください。
${PORT:-8080}:80 を公開。frontend ネットワークopenproject/openproject:${TAG:-17-slim}。autoheal が /var/run/docker.sock をマウントする点は、権限設計上おさえておく価値があります。6立てたあとに残る仕事
インストールが終わっても、運用として持ち続けるものがあります。ここを見積もらないと「安く済んだつもりが一番高い」になります。
7自分で建てるか、任せるか
構築も、更新の追随も、こちらで
Projo は OpenProject を日本語・フルマネージドで提供します。PostgreSQL 16 の用意も拡張の有効化も、バックアップも更新追随も、こちらの担当です。
事前登録するよくある質問
OpenProjectのインストール方法は何がありますか?
公式ドキュメントには Docker Compose、DEB/RPMパッケージ、単一Dockerコンテナ、Helmチャート、その他(Kubernetes等)の5つが挙げられており、「We recommend using the Docker installation.」としてDockerが推奨されています。
必要なサーバーのスペックは?
公式の最小要件はクアッドコアCPU(2GHz以上)、メモリ4,096MB、空きディスク20GBです。効くのは総ユーザー数ではなく同時実行数で、約500ユーザーあたりデータベースに2CPU/8GiB RAM、アプリに4〜6CPUという目安が公式に示されています。
MySQLは使えますか?
実質使えません。公式のシステム要件に挙がっているのはPostgreSQLだけで、MySQLの記載はありません。公式の導入FAQには、性能とSQL機能の最適化のため両方を支え続けるのは現実的でないとして、MySQLのサポートを外す方針が書かれています。既存のMySQLからは pgloader でPostgreSQLへ移行する手順が案内されています。
PostgreSQLはどのバージョンが必要ですか?
OpenProject 16.0.0以降、公式にサポートされるのはPostgreSQL 16以上です。13〜15は「公式サポート対象外だが動作する可能性はある。ただし非互換や性能劣化を招きうる」と明記されています。拡張として pg_trgm、btree_gist、unaccent が必要です。
公式のdocker-composeをそのまま使って大丈夫ですか?
最低2点は変更すべきです。1つはデータベースのパスワードで、stable/15〜17のいずれも POSTGRES_PASSWORD の既定値が p4ssw0rd です(環境変数で上書きする前提の設計で、DBコンテナはホストにポート公開されていません)。もう1つはPostgreSQLのバージョンで、既定の POSTGRES_VERSION が13のため、公式が推奨する16以上に上げる必要があります。
Windowsで動きますか?
公式に「At the moment this is not officially supported」と書かれており、サポート対象外です。またパッケージ版については、Ubuntu 24.04のような新しいLinuxバージョン向けを提供する予定はないと明記されています。
出典
- OpenProject 公式リポジトリ(タグ
v17.6.0) — github.com/opf/openproject(取得日 2026-08-03) - Redmine 公式リポジトリ(タグ
7.0.0・2026-06-30) — github.com/redmine/redmine(取得日 2026-08-03) - OpenProject 料金 — openproject.org/pricing(取得日 2026-08-03)
- OpenProject システム要件 — openproject.org/docs/…/system-requirements(取得日 2026-08-03)
- OpenProject 公式ドキュメント Installation FAQ(MySQL に関する記述) —
docs/installation-and-operations/installation-faq/README.md(タグv17.6.0) - OpenProject 本番用 docker-compose — github.com/opf/openproject-docker-compose の
stable/15/stable/16/stable/17(取得日 2026-08-03)
既定パスワードとPostgreSQLの既定バージョンは、上記composeファイルを直接読んで確認した2026-08-03時点の値です。いずれも環境変数で上書きできる設計であり、脆弱性の指摘ではなく「既定のまま使わないこと」の注意喚起です。公式の記述は原文のまま引用し、訳は当サイトによります。