VPSにDockerでERPNextをセルフホストする方法
ERPNextをVPSで運用する手順です。11個のコンテナ構成、必要な容量、TLS、送信メール、バージョン固定、実際に復元を確認したバックアップまで解説します。
実行のために準備する内容
VPS で ERPNext をセルフホストする作業は、1 つのコマンドで完了するインストールではなく、運用作業です。公式の Docker Compose スタックは 11 個のコンテナで構成され、総勘定元帳と顧客情報を保持します。そのため、以下のすべてで高い運用水準が求められます。バックアップは復元できることを確認して初めてバックアップになります。また、イメージタグを固定しないと、予期しないスキーマ移行が発生するおそれがあります。
ここでは、いくつかの名称を使います。ERPNext は業務アプリケーションです。Frappe はその基盤となる Python フレームワークです。Bench はサイトを管理するコマンドラインツールで、コンテナ内にあらかじめインストールされています。サイト は 1 つのテナントです。1 つの MariaDB データベースと、アップロードしたファイルを格納する 1 つのディレクトリで構成されます。ここで示すほぼすべてのコマンドは、backend コンテナ内で bench を実行し、名前を指定した 1 つのサイトを対象にします。
このガイドでは、プロジェクトが保守しているデプロイメントである frappe_docker リポジトリを使用します。以下のすべてのコマンドは、2026 年 8 月にこのリポジトリで確認済みです。Docker Compose が初めての場合は、VPS で Docker Compose を実行する方法で、このガイドが前提とする基本事項を説明しています。
ERPNext にはどの程度の VPS が必要ですか?
このグラフのデータ
[
{
"label": "Evaluation",
"vcpu": 2,
"ram_gb": 4,
"disk_gb": 40
},
{
"label": "Small production",
"vcpu": 4,
"ram_gb": 8,
"disk_gb": 100
},
{
"label": "Room to grow",
"vcpu": 4,
"ram_gb": 16,
"disk_gb": 160
}
]評価用途では、2 vCPU と 4 GB の RAM から始めてください。これが評価用の構成です。これは開始点であり、このガイドで測定した値ではありません。実際に必要な容量は、使用するドキュメントの量で決まります。最後の行は、公開されている最小要件ではありません。メモリに余裕を持たせるための値であり、メモリ不足が決して発生しないことを保証するものではありません。
小容量のプランについては、現実的に判断してください。1 GB または 2 GB の VPS では、長時間稼働する 10 個のコンテナ、MariaDB の buffer pool、レポートを作成する Python worker を同時に動かす余裕はほとんどありません。メモリが逼迫すると、kernel の out of memory killer がコンテナを停止することがあります。その場合、docker inspect には "OOMKilled": true が exit code 137 とともに表示されます。worker がジョブの途中で停止すると、送信済みのドキュメントでもバックグラウンド処理が途中までしか完了しないことがあります。
会社で ERPNext を毎日使用する場合は、8 GB の RAM、4 vCPU、100 GB の SSD を基準に計画し、実際のワークロードをテストしてください。最初に不足するのは RAM です。すべての添付ファイルとローカルバックアップがデータベースと同じボリュームに保存されるため、ディスク使用量は想定より速く増加します。
11 個のコンテナと、それぞれの役割
スタックが起動し、10 個のコンテナが実行された後に docker compose ps を実行します。もう 1 つの configurator は 1 回だけ処理を実行して終了します。これが合計 11 個になる理由です。
backendは gunicorn 上で Frappe アプリケーションを実行します。ここにbenchがあります。frontendは nginx です。静的アセットを配信し、それ以外のリクエストをバックエンドへ転送します。queue-shortとqueue-longは RQ (Redis Queue) ワーカーです。送信メール、インポート、レポート生成などのバックグラウンドジョブを実行します。schedulerは、スケジュールされたレポートや自動繰り返しドキュメントなど、時刻に基づくジョブを実行します。websocketは、ブラウザーのライブ更新を担う socket.io プロセスです。dbは MariaDB です。redis-cacheとredis-queueは、キャッシュ用とジョブキュー用に分けた 2 つの Redis インスタンスです。proxyは Traefik です。HTTPS override によって追加されます。ポート 80 と 443 を受け持ち、証明書を取得します。
この分割を理解しておくと、どのログを読むべきか判断できます。メールがキューに滞留している場合は、キューワーカーの問題です。そのため、docker compose logs -f queue-short が適切なコマンドです。ページは読み込まれるのに通知バッジが更新されない場合は、websocket の問題です。どちらの場合も backend のログを読むと、原因の切り分けに時間がかかります。
本番用の compose ファイルでインストールする(デモ用ではない)
リポジトリには pwd.yml が含まれています。README には次のように明記されています。「この構成は短時間の評価専用です。この構成にはカスタムアプリをインストールできません。」午後の間 ERPNext を確認する用途には使えます。会社の運用には使わないでください。
sudo apt update && sudo apt install -y git
curl -fsSL https://get.docker.com | bash
git clone https://github.com/frappe/frappe_docker
cd frappe_docker
mkdir -p ~/gitops
cp example.env ~/gitops/erpnext.env~/gitops/erpnext.env を開き、4 つの値を変更します。ERPNEXT_VERSION でイメージタグを固定します。DB_PASSWORD はサンプルファイルでは 123 として指定されています。SITES_RULE は Traefik のルーティングルールで、LETSENCRYPT_EMAIL で ACME アカウントのメールアドレスを指定します。Let's Encrypt は 2025 年 6 月 4 日に有効期限通知メールを終了したため、証明書の有効期限は別途監視してください。
ERPNEXT_VERSION=v16.32.1
DB_PASSWORD=<a long random password>
SITES_RULE=Host(`erp.example.com`)
LETSENCRYPT_EMAIL=ops@example.comここで compose ファイルを 1 つに展開し、その後起動します。
docker compose --project-name erpnext \
--env-file ~/gitops/erpnext.env \
-f compose.yaml \
-f overrides/compose.mariadb.yaml \
-f overrides/compose.redis.yaml \
-f overrides/compose.https.yaml \
config > ~/gitops/erpnext.yaml
docker compose --project-name erpnext -f ~/gitops/erpnext.yaml up -d
export COMPOSE_FILE="$HOME/gitops/erpnext.yaml"config は何も起動しません。ベースファイルと上書き設定をマージし、すべての変数を展開した結果を出力します。その後、その展開済みファイルを実行します。この手順には意味があります。実行中のスタックが読み取り可能な 1 つのファイルになるため、誰かが env ファイルを編集したり、リポジトリを pull したりしても、実行中に内容が変わることがありません。複数の Docker Compose ファイルのマージ方法 では、上書きルールを詳しく説明しています。
COMPOSE_FILE の export により、以下のコマンドは展開済みファイルを使用します。新しいシェルを開くたびに再度実行してください。cron では -f ~/gitops/erpnext.yaml を明示的に指定します。
db が起動し、configurator が終了するまで待ちます。数秒かかります。その後、サイトを作成します。
docker compose --project-name erpnext exec backend \
bench new-site --mariadb-user-host-login-scope=% \
--db-root-password '<your DB_PASSWORD>' \
--install-app erpnext \
--admin-password '<a strong admin password>' \
erp.example.com確認します。
docker compose --project-name erpnext ps
docker compose --project-name erpnext exec backend bench --site erp.example.com list-appslist-apps は、バージョン付きの frappe と erpnext を出力するはずです。正常な ps では、running 状態のサービスが 10 個表示され、restarting 状態のサービスはありません。
ここでは、2 つの問題がよく発生します。--mariadb-user-host-login-scope=% により、新しいサイトのデータベースユーザーにはワイルドカードのホスト範囲が設定されます。そのため、Docker がアプリコンテナに別のアドレスを割り当ててもログインできます。これを指定しない場合、Frappe は現在の接続元ホストにユーザーを限定します。アプリコンテナは Docker ネットワーク経由で MariaDB に接続するため、リモートホストとして接続します。localhost に限定されたデータベースユーザーは、そこからログインできません。このオプションが変更するのはサイトのデータベースユーザーであり、root アカウントではありません。% の範囲では、MariaDB に到達できる任意のホストからの接続を許可します。そのため、データベースはプライベートな Docker ネットワークに置いてください。
2 つ目はサイト名です。デフォルトでは、フロントエンドは HTTP の Host ヘッダーから提供するサイトを選択します。そのため、erpnext として作成したサイトは、両方が存在していても erp.example.com では到達できません。上記のようにドメインに合わせてサイト名を付けるか、env ファイルで FRAPPE_SITE_NAME_HEADER にサイト名を設定し、compose ファイルを再度展開してください。
HTTPS と、動作前に満たす必要がある条件
compose.https.yaml の設定では、Traefik がポート 443 で動作し、ポート 80 からのアクセスを HTTPS にリダイレクトし、Let's Encrypt に証明書を要求します。TLS(トランスポート層セキュリティ)により、請求書やセッション Cookie が平文のままネットワーク上を流れることを防ぎます。
証明書を発行するには、2 つの条件を満たす必要があります。満たさなければ、証明書は発行されません。erp.example.com の DNS A レコードが、あらかじめ VPS を指していなければなりません。また、インターネットからポート 80 と 443 に到達できる必要があります。Let's Encrypt は、ポート 80 の HTTP-01 チャレンジで、その名前を管理していることを確認するためです。プロバイダー側のネットワークファイアウォールと、サーバー上のファイアウォールの両方を確認してください。これらは別々の制御であり、パネル側のファイアウォールは見落とされやすい箇所です。
証明書は cert-data ボリューム内の /letsencrypt/acme.json に保存されます。ブラウザーに自分の証明書ではなくデフォルトの証明書が表示される場合は、docker compose --project-name erpnext ps でプロキシサービス名を確認し、そのログから ACME(自動証明書管理環境)のエラーを調べてください。同じサーバーで他の Web アプリケーションも運用しますか。複数の Docker Compose アプリの前段に 1 つの Traefik インスタンスを置く方法では、ポート 443 の競合を避けながらプロキシを共有する方法を説明しています。このようなサーバー上の 2 つ目のアプリは、顧客向けであることがよくあります。自己ホスト型 Chatwoot サポートデスクも同じプロキシの背後で動作するため、請求書を扱う担当者が同じ場所で顧客のメールやチャットにも対応できます。
送信メールを設定しないと、請求書は送信されません
これは、多くの ERPNext ガイドで省略される手順ですが、システムが実用になるかどうかを左右します。送信メールが機能しなければ、顧客に請求書が届かず、パスワードリセットも届かず、スケジュール済みレポートも配信されません。この構成にはメールサーバーが含まれていません。
VPS から port 25 を直接使ってメールを送信しないでください。AWS などのプロバイダーは、デフォルトで outbound port 25 をブロックします。また、履歴がほとんどない、またはまったくない新規送信 IP は、拒否や spam フォルダーへの振り分けのリスクを高めます。どちらも避けられないわけではありません。port 587 の認証済み relay を使用し、まずプロバイダーの outbound ルールを確認してください。DigitalOcean では、デフォルトで Droplet の ports 25、465、587 がブロックされます。
推奨される方法は、ERPNext インターフェースの Email Account 画面を使用することです。パスワードは暗号化して保存されます。キーを site config に直接書き込むこともできます。
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-config mail_server smtp.example.com
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-config mail_port 587 --parse
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-config use_tls 1 --parse
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-config mail_login 'erp@example.com'
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-config auto_email_id 'erp@example.com'--parse は 587 を文字列 "587" ではなく数値として保存します。ファイルを読み戻し、この 2 つの値が引用符で囲まれていないことを確認してください。
docker compose --project-name erpnext exec backend \
cat sites/erp.example.com/site_config.json暗号化されたパスワード保存を使用する場合は、送信サーバー、ログイン情報、パスワードを Email Account 画面でまとめて設定してください。この画面のパスワード欄は、独立した mail_password site config キーを設定しません。
次に、実際にメッセージを送信します。Sales Invoice を作成し、自分で管理しているアドレスにメールで送信します。その間、キューを監視してください。
docker compose --project-name erpnext logs -f queue-short送信メールはバックグラウンドジョブとして処理されます。そのため、メッセージが届かない場合は、ブラウザーのエラーではなく、そのログに failed job として記録されることが一般的です。送信ドメインには SPF(sender policy framework)と DKIM(domainkeys identified mail)のレコードも公開し、DMARC ポリシーを追加してください。認証がなければ、技術的に正しい請求書でも拒否されたり、spam フォルダーに振り分けられたりする可能性があります。経路全体を自分で管理したい場合は、自己ホスト型の Mailcow メールサーバーを使用できます。ERP とは別のサーバー上で、自分で管理する relay を構築できます。
実際に復元できるバックアップ
データベースダンプだけでは、ERPNext のバックアップになりません。添付ファイルとプライベートファイルは MariaDB ではなく sites ディレクトリに保存されます。データベースだけを復元すると、アップロード済みのすべての発注書が壊れたリンクになります。
docker compose --project-name erpnext exec backend \
bench --site erp.example.com backup --with-filesこれにより、sites ボリューム内の sites/erp.example.com/private/backups に 4 つのファイルが作成されます。
-database.sql.gzダンプ- 公開ファイルの
-files.tarアーカイブ - プライベートファイルの
-private-files.tarアーカイブ - サイト設定の
-site_config_backup.jsonコピー
4 つ目のファイルは破棄されがちですが、最も大きな問題を引き起こします。このファイルには encryption_key が含まれています。これは、Frappe が保存済みパスワードを暗号化するために使用するキーです。対象には、メールアカウントの認証情報、決済ゲートウェイのキー、すべての連携用 Secret が含まれます。一致するキーなしでデータベースを復元すると、サイトは正常に読み込まれますが、メール送信に失敗します。
frappe.exceptions.ValidationError: Encryption key is invalid! Please check site_config.json常に 4 つのファイルを一緒に保管してください。
次に、これらのファイルをサーバー外へ移します。ボリューム内のバックアップはサーバー障害時に失われます。また、bench はそのディレクトリ内の 23 時間より古いバックアップをデフォルトで削除します。このデフォルト値は、Frappe 16.20.0 および 15.114.0 より前は 24 時間でした。サイト設定の keep_backups_for_hours キーでこの値を上書きできます。
docker compose --project-name erpnext cp \
backend:/home/frappe/frappe-bench/sites/erp.example.com/private/backups \
~/erpnext-backupsこれを cron から実行し、ディレクトリを自分で管理していない場所へ送信します。暗号化してオフサイトストレージへ保存する restic バックアップ が適しています。アップロード前に暗号化でき、restic check によりリポジトリを引き続き読み取れることを確認できるためです。ERP のバックアップは台帳全体のコピーです。そのため、暗号化した状態で、このサーバーとは別のハードウェアに保存してください。
必要になる前にリストアをテストする
テストしていないバックアップは推測にすぎません。同じサーバー上の別サイトにリストアしてテストし、本番サイトには決してリストアしないでください。
docker compose --project-name erpnext exec backend \
bench new-site --mariadb-user-host-login-scope=% \
--db-root-password '<your DB_PASSWORD>' \
--admin-password '<a strong admin password>' \
restore-test.example.com
docker compose --project-name erpnext exec backend \
bench --site restore-test.example.com --force restore \
sites/erp.example.com/private/backups/<stamp>-erp_example_com-database.sql.gz \
--with-public-files sites/erp.example.com/private/backups/<stamp>-erp_example_com-files.tar \
--with-private-files sites/erp.example.com/private/backups/<stamp>-erp_example_com-private-files.tar \
--db-root-password '<your DB_PASSWORD>'バックアップした設定から暗号化キーをリストア先のサイトにコピーしてください。コピーしないと、連携機能が動作しません。
docker compose --project-name erpnext exec backend \
bench --site restore-test.example.com set-config encryption_key '<value from site_config_backup.json>'次に、会計担当者と同じ観点でリストアを確認します。売掛金レポートを開き、期末残高を本番サイトと比較してください。最近の仕入請求書を開き、添付ファイルをダウンロードしてください。ログインページが表示されるだけでは、何も確認できません。
確認が終わったら、テストサイトを削除してください。
docker compose --project-name erpnext exec backend \
bench drop-site restore-test.example.comERPNext でバージョン固定がより重要な理由
静的サイトでは、イメージタグを固定しないと予期しない再起動が発生します。ERPNext では、データベーススキーマのマイグレーションが発生します。bench migrate はデータベーステーブルを書き換え、ドキュメントデータを書き換える場合もあります。元に戻す機能はありません。ロールバックはバックアップからのリストアであり、docker compose down ではありません。
そのため、タグを固定してください。ERPNEXT_VERSION=v16.32.1 は、2026 年 8 月にリポジトリ自身の pwd.yml で固定されていたリリースです。2026-11-16 時点では、pwd.yml と example.env の両方が v16.55.0 に固定されていました。確認せずに、いずれの番号も引き継がないでください。現在のリリースは frappe/erpnext リリースページ に、利用可能なイメージタグは Docker Hub に掲載されています。移行する前に、移行先バージョンのリリースノートを読んでください。
アップグレードは、バックアップの取得とメンテナンスモードの有効化から始めます。
docker compose --project-name erpnext exec backend \
bench --site erp.example.com backup --with-files
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-maintenance-mode on~/gitops/erpnext.env の ERPNEXT_VERSION を編集し、その後 render、pull、migrate を実行します。
docker compose --project-name erpnext \
--env-file ~/gitops/erpnext.env \
-f compose.yaml \
-f overrides/compose.mariadb.yaml \
-f overrides/compose.redis.yaml \
-f overrides/compose.https.yaml \
config > ~/gitops/erpnext.yaml
docker compose --project-name erpnext -f ~/gitops/erpnext.yaml pull
docker compose --project-name erpnext -f ~/gitops/erpnext.yaml up -d
docker compose --project-name erpnext exec backend \
bench --site erp.example.com migrate
docker compose --project-name erpnext exec backend \
bench --site erp.example.com set-maintenance-mode offメンテナンスモードが重要なのは、実行中に migrate がスキーマを変更するためです。マイグレーション途中のテーブルに対してユーザーがドキュメントを送信すると、レコードを手作業で修復することになります。
メジャーバージョンは一度に 1 つだけ進め、各ステップの間にバックアップを取得してください。続行する前に、各メジャーバージョンのマイグレーション手順を確認してください。
このリポジトリには overrides/compose.migrator.yaml も含まれています。これは、サイトが存在し、MIGRATE_SITES が有効な場合に、起動時に bench --site all migrate を実行するコンテナを追加します。MIGRATE_SITES はデフォルトで有効です。便利な機能です。一方で、タグを変更した docker compose up によって、誰も監視していない状態で本番データベースがマイグレーションされることも意味します。業務システムでは、migrate はその日の判断として実行してください。
顧客記録を保持するサーバーのセキュリティ強化
初回ログイン時に Administrator のパスワードを変更します。評価用の compose ファイルでは、パスワードとして admin が設定されています。この習慣を本番環境に持ち込まないでください。
example.env の 123 を DB_PASSWORD に変更します。その値は平文のまま、生成された ~/gitops/erpnext.yaml に入ります。そのため、chmod 600 ファイルを保護し、git リポジトリには保存しないでください。より安全にするには、overrides/compose.mariadb-secrets.yaml を使用します。これは環境変数ではなく Docker secret ファイルからパスワードを読み取ります。Docker Compose での環境変数ファイルと Secret の扱いでは、これらのトレードオフを説明しています。
必要なポートだけを公開します。HTTPS 用の override を使用すると、公開されるポートは 80 と 443 だけです。データベースクライアントを接続しやすくするために、db サービスへ ports のマッピングを追加しないでください。これにより MariaDB がインターネットへ公開されます。代わりに docker compose --project-name erpnext exec backend bench mariadb を使用します。ホストでは 22、80、443 のみを許可し、それ以外を拒否します。プロバイダー側の独立したネットワークファイアウォールも確認してください。
System Manager ロールを持つすべてのアカウントで、System Settings の二要素認証を有効にします。このロールには System Settings を変更する権限があるため、単なる利便性のためのアカウントではなく、管理者アカウントとして扱ってください。複数のセルフホストアプリを運用する場合は、アプリごとにパスワードを増やすより、セルフホスト型シングルサインオンプロバイダーとしての Authentikを使用する方が適しています。
ホストにパッチを適用し、kernel の更新後に再起動します。再起動後にスタックが復旧すると判断する前に、生成されたファイルで各サービスに restart ポリシーが設定されていることを確認してください。これがないスタックは、その再起動後に停止したままになります。Docker Compose スタックを再起動後に再び起動させる方法では、systemd 側の設定を説明しています。
1 台の VPS で ERPNext の運用が難しくなるとき
1 台の VPS で小規模な会社を長期間運用できます。次の兆候が現れたら、限界が近づいています。
- バックグラウンドジョブが滞留し、メールやインポートの処理が数分から数時間遅れます。
docker inspectが、"OOMKilled": trueまたは終了コード 137 のコンテナを報告します。- 2 秒で完了していたレポートに 30 秒かかり、MariaDB が CPU を占有するプロセスになります。
- バックアップの実行時間が長くなり、次回のスケジュール実行と重なります。
まず、MariaDB に共有されていないリソースを割り当てます。データベースと Python ワーカーが同じメモリを奪い合い、バッファプールはより多くのメモリを必要とするためです。アプリケーションサーバーを大きくしても、期待するほどの効果はありません。データベースを Docker またはホスト上で実行するでは、この判断について説明しています。Docker Compose でメモリ制限を設定することで、対応中に 1 つのコンテナが他のコンテナのリソースを枯渇させることを防げます。
次に、Web の処理能力ではなくキューワーカーを追加します。ERPNext で時間のかかる処理は、レポート生成や一括インポートなどのバックグラウンド処理です。ワーカーを増やすには CPU とメモリに余裕が必要です。すでにリソースを使い切っている VPS にコンテナを追加しても、処理能力は増えません。
FAQ
ERPNext には VPS 上でどの程度の RAM が必要ですか?
評価目的であれば、4 GB の RAM と 2 vCPU から始めてください。毎日利用する会社では、8 GB の RAM、4 vCPU、100 GB の SSD を計画します。メモリが逼迫すると、kernel の out of memory killer がコンテナを停止することがあります。この状態は docker inspect では "OOMKilled": true、終了コード 137 として報告されます。これらは測定値ではなく開始時の目安です。最初の 1 か月は実際のメモリ使用量を監視してください。
本番環境で pwd.yml を実行できますか?
いいえ。プロジェクトの README では、短時間の評価用途のみを想定していると説明されています。また、カスタムアプリをインストールできないことも記載されています。MariaDB、Redis、HTTPS の override とともに compose.yaml を使用し、docker compose config で 1 つのファイルにレンダリングして、そのファイルを実行してください。
作成直後の ERPNext サイトにアクセスできないのはなぜですか?
デフォルトでは、frontend が HTTP の Host header に基づいて提供するサイトを選択します。そのため、サイト名はブラウザーの domain と一致している必要があります。erpnext として作成したサイトは、erp.example.com では提供されません。domain をサイト名としてサイトを作成するか、env file の FRAPPE_SITE_NAME_HEADER にサイト名を設定してください。その後、compose file を再度レンダリングして stack を再起動します。
ERPNext のバックアップには何を含める必要がありますか?
4 つのファイルをまとめて保管します。-database.sql.gz dump、-files.tar archive、-private-files.tar archive、-site_config_backup.json config copy です。bench --site erp.example.com backup --with-files を実行すると、4 つすべてが生成されます。config copy には encryption_key が含まれます。そのため、これがない状態で復元すると、保存された integration password を復号できず、Encryption key is invalid! Please check site_config.json として現れます。
データを壊さずに ERPNext をアップグレードするにはどうすればよいですか?
--with-files でバックアップを作成し、maintenance mode を有効にします。env file の ERPNEXT_VERSION を変更し、compose file を再度レンダリングして pull し、stack を起動します。その後、bench --site erp.example.com migrate を実行して maintenance mode を無効にします。メジャーバージョンは 1 つずつ移行し、最初に release notes を確認してください。migrate は schema と document data を元に戻せない形で書き換えるためです。ロールバックするには、最初に作成したバックアップを復元します。