VPSにDockerでChatwootをセルフホストする方法
VPSでChatwootをDocker ComposeとTraefikで構築します。固定タグ、確実に届くSMTP、pgvector対応Postgresとアップロードのバックアップ、安全なアップグレードを解説します。
構築するもの
VPS で Chatwoot をセルフホストするには、4 つのコンテナを実行します。Rails の Web プロセス、Sidekiq のバックグラウンドワーカー、pgvector 拡張機能を有効にした PostgreSQL、Redis です。Chatwoot はオープンソースのカスタマーサポートデスクです。そのため、自分で管理するサーバー上に、チームで共有する受信トレイと Web サイト用のチャットウィジェットを用意できます。インストールには約 20 分かかります。その後のメール配信、バックアップ、アップグレード、リソースのサイジングが、1 年後も稼働し続けるかどうかを左右します。
各コンテナには 1 つの役割があります。Rails はエージェント用ダッシュボードとウィジェット API(application programming interface)を提供します。Sidekiq は、メール送信、接続済みチャネルのポーリング、自動化ルールの実行、レポートの生成など、時間のかかる処理を実行します。Postgres は、会話、連絡先、エージェントアカウント、ダッシュボードで変更したすべての設定を保持します。Redis は Sidekiq のキューと、開いているダッシュボードにページを再読み込みせず新しいメッセージを配信する ActionCable の pub/sub チャネルを保持します。ここで Redis は一時的なキャッシュではありません。Redis を失うと、キュー内のジョブも失われるためです。
upstream の compose ファイルで使用されている Postgres イメージは、標準の postgres イメージではなく pgvector/pgvector:pg16 です。Chatwoot のスキーマが AI 機能用に vector 拡張機能を有効にするためです。標準の Postgres に置き換えると、拡張機能の control file がそのイメージに存在しないため、最初のデータベース起動が ERROR: extension "vector" is not available で停止します。upstream がリリースしているイメージを使用してください。
このガイドでは、Docker とリバースプロキシがすでにサーバー上で動作していることを前提にします。動作していない場合は、まず VPS 上の Docker Compose を参照してから戻ってきてください。
自己ホスト型 Chatwoot には、どの程度の VPS が必要ですか?
2026年10月時点で、upstream の要件ページでは、最小構成として 4 GB の RAM と 4 CPU コアを求めており、1日あたり最大 10,000 件の会話に対応できるとしています。8 GB と 8 コアの構成は、1日あたり最大 20,000 件です。また、少なくとも 1 GB の swap も必要です。理由も明記されており、アップグレード中にマシンのメモリが枯渇しないようにするためです。ファイルアップロードを除き、Postgres 用に 5 GB から 10 GB のディスク容量を見込んでください。
率直に言うと、2 GB の VPS でも Chatwoot は起動し、エージェントが 2 人で受信トレイが静かなら問題なく動作しているように見えます。しかし、2 か所で停止しやすくなります。1 つ目は Sidekiq です。upstream の計測では、負荷の高いサーバーで 1 GB を超えるため、メールの集中やレポート処理によって、Rails、Postgres、Redis が必要なメモリを確保する前にマシンのメモリが枯渇します。2 つ目はアップグレードです。db:chatwoot_prepare はマイグレーションを適用するために新しい Rails プロセスを起動します。このイメージでは、実際の処理を始める前に Rails の起動だけで数百 MB を消費します。
最初に分かりやすい警告が表示されるとは限りません。カーネルの out of memory killer が選択したプロセス(通常は最も大きいプロセス)に SIGKILL を送り、Docker がコンテナの停止を検知すると、restart: always が再起動します。その結果、docker compose ps --all には再起動を繰り返すコンテナ、または Exited (137) の状態にあるコンテナが表示されます。137 は signal 9 によって強制終了されたことを示します。--all を省略すると、停止したコンテナは一覧に表示されません。ただし、終了コード 137 だけではメモリが原因だとは断定できません。docker kill も同じシグナルを送るためです。sudo dmesg -T | grep -i "killed process" で、カーネルが選択したプロセスを確認してください。
4 GB が予算を超える場合は、2 GB のマシンに 2 GB の swap を設定して運用し、負荷時には応答時間が悪化することを受け入れてください。swap はメモリ枯渇を防ぐためのバッファであり、保証ではありません。そのため、十分に大きな負荷が一度に発生すると、コンテナが強制終了されることがあります。いずれの場合も、サービスごとにハードメモリ上限を設定する価値があります。これにより、worker がデータベースまで停止させる事態を防げます。Docker Compose のメモリ制限を参照してください。
ファイルアップロードは、設定した上限なしに増え続ける部分です。顧客が添付するスクリーンショットはすべてストレージボリュームに保存され、そのまま残ります。そのため、ディスクを使い果たした原因がデータベースだと思い込まず、docker system df -v を監視してください。
compose ファイルを取得し、バージョンタグを固定する
mkdir -p ~/chatwoot && cd ~/chatwoot
wget -O .env https://raw.githubusercontent.com/chatwoot/chatwoot/develop/.env.example
wget -O docker-compose.yaml https://raw.githubusercontent.com/chatwoot/chatwoot/develop/docker-compose.production.yaml
chmod 600 .envダウンロードしたファイルには image: chatwoot/chatwoot:latest と記載されています。ほかの作業を始める前に変更してください。
services:
base: &base
image: chatwoot/chatwoot:v4.19.1
env_file: .env
volumes:
- storage_data:/app/storagelatest のままにすると、次の docker compose pull はその朝に公開されたものを取得します。移行を伴うメジャーバージョンが含まれる可能性もあります。Chatwoot のマイグレーションは、実際の運用では元に戻せません。そのため、意図しない更新が発生した場合は、取り消しではなくバックアップからの復元が必要です。タグを固定し、意図的に変更してください。2026年10月25日時点の現行リリースは v4.19.1 です。このリリースのノートでは、最新のセキュリティ修正と強化を含む推奨バージョンとして案内されています。現在固定すべきタグは、リリースページで確認してください。v4.18.0 以前から更新する場合は、まず v4.19.0 のリリースノートを確認してください。Captain V1 は廃止されており、V1 の手順を使用しているセルフホスト環境は、更新前に V2 へ移行する必要があります。データベースを管理するソフトウェアでは、同じ注意が必要です。そのため、openGym ワークアウトトラッカーをセルフホストする方法では、このソフトウェアよりはるかに小規模なアプリケーションであっても、最初に git タグを固定します。
base サービスは YAML アンカーです。rails と sidekiq はこのアンカーをマージするため、1 か所でタグを変更すると両方に反映されます。ファイルを開いている間に、先頭にある version: '3' 行も削除してください。現在の Compose ではこの行は無視され、すべてのコマンドで the attribute 'version' is obsolete, it will be ignored が表示されます。
.env ファイルを入力する
まず Secret を生成します。Upstream は英数字の値を求めています。値が shell や YAML パーサーを通る際に、特殊文字が正しく処理されないためです。
head /dev/urandom | tr -dc A-Za-z0-9 | head -c 63 ; echo ''次に、.env で次のキーを設定します。
SECRET_KEY_BASE=<the 63 characters you just generated>
FRONTEND_URL=https://support.example.com
FORCE_SSL=true
DEFAULT_LOCALE=en
ENABLE_ACCOUNT_SIGNUP=true
POSTGRES_HOST=postgres
POSTGRES_USERNAME=postgres
POSTGRES_PASSWORD=<long random string>
POSTGRES_DATABASE=chatwoot
REDIS_URL=redis://redis:6379
REDIS_PASSWORD=<a different long random string>
RAILS_ENV=production
INSTALLATION_ENV=docker
ACTIVE_STORAGE_SERVICE=localPOSTGRES_HOST=postgres と redis://redis:6379 は Compose のサービス名です。プロジェクトのデフォルトネットワーク上で名前解決されます。FRONTEND_URL は単なる表示用の値ではありません。Chatwoot はこの値からウィジェットのスクリプト URL と、送信メール内のすべてのリンクを生成します。そのため、誤った値を設定すると、応答しないホストを指すパスワードリセットリンクが生成されます。
ここで、Upstream のファイルにある落とし穴を確認します。postgres サービスは .env を読みません。独自の environment ブロックを持ち、POSTGRES_PASSWORD= は空のままです。そのため、.env だけにパスワードを設定すると、データベースにはパスワードが設定されず、アプリケーションにだけパスワードが設定されます。サービスから同じ変数を参照するようにします。
postgres:
image: pgvector/pgvector:pg16
restart: always
volumes:
- postgres_data:/var/lib/postgresql/data
environment:
- POSTGRES_DB=chatwoot
- POSTGRES_USER=postgres
- POSTGRES_PASSWORD=${POSTGRES_PASSWORD}Compose はプロジェクトディレクトリの .env を読み込み、${...} の置換に使用します。これで両方に同じ文字列が渡されます。ここを誤ると、Rails は PG::ConnectionBad: FATAL: password authentication failed for user "postgres" で停止します。
ほとんどの人が驚く動作が 1 つあります。Postgres イメージが POSTGRES_PASSWORD を適用するのは、空のデータディレクトリを初期化するときだけです。後から値を変更しても効果はありません。initdb は 2 回目には実行されないためです。すでにスタックを 1 回起動している場合は、データベース内で値を変更してください。
docker compose exec postgres psql -U postgres -c "ALTER USER postgres WITH PASSWORD 'the-new-password';"ENABLE_ACCOUNT_SIGNUP=true は一時的な設定です。最初のアカウントを作成できるように、公開された登録フォームを開きます。アカウントを作成したら、false に設定して、すぐに docker compose up -d を再度実行してください。URL を見つけた人なら誰でも、サポート窓口に登録できてしまいます。以後、エージェントは招待によって追加され、パスワードはこのアプリ内だけで管理されます。これは、サービスが半ダースほどに増え、各サービスで別々のアカウント一覧を管理することに疲れるまでは問題ありません。その段階では、Authentik のような自己ホスト型の ID プロバイダーが、それらを置き換える役割を果たします。
.env には、このスタックが使用するすべての Secret が平文で保存されます。そのため、mode 600 に設定し、git の管理対象外にしてください。Compose が env ファイルを読み込む方法と Secret が漏えいする場所では、env_file と environment の違いを含め、注意すべき点を説明しています。
既存の Traefik の背後に Chatwoot を配置する
1 つのアプリケーションに 2 つ目のリバースプロキシを構築しないでください。このサーバー上の他のコンテナで Traefik がすでに TLS (transport layer security) を終端している場合、Chatwoot はラベルブロックを追加してその構成に参加させます。まだ Traefik を導入していない場合は、複数の Docker Compose アプリケーションの前段に Traefik を配置する の手順で一度設定してから、ここに戻ってください。
上流の docker-compose.yaml は後で新しいコピーとの差分を確認できるよう、できるだけ元の構成に近い状態に保ち、変更内容は override ファイルに記述してください。Compose は docker-compose.override.yaml を自動的にマージします。マージ規則については、Compose を複数のファイルに分割する で説明しています。
services:
rails:
networks:
- default
- proxy
labels:
- "traefik.enable=true"
- "traefik.http.routers.chatwoot.rule=Host(`support.example.com`)"
- "traefik.http.routers.chatwoot.entrypoints=websecure"
- "traefik.http.routers.chatwoot.tls.certresolver=letsencrypt"
- "traefik.http.services.chatwoot.loadbalancer.server.port=3000"
networks:
proxy:
external: trueentrypoint と certresolver には独自の名前を使用してください。コンテナは Traefik と同じ Docker ネットワークに接続する必要があります。これを指定するのが proxy の設定です。また、default にも接続したままにしてください。そうしないと Postgres と Redis を利用できなくなります。後者の行は忘れられがちです。
ports: ブロックは変更しないでください。上流の構成ではこれが 127.0.0.1:3000 にバインドされます。これは loopback 専用なので、インターネットから到達できません。また、curl -I http://127.0.0.1:3000 を使えばサーバー内部からテストできるため、そのまま役立ちます。
エージェントダッシュボードは、ライブメッセージ配信のために /cable への websocket 接続を維持します。Traefik は追加設定なしで HTTP upgrade を転送するため、何も追加する必要はありません。後から CDN や別のプロキシを Traefik の前段に配置する場合は、そこで websockets を許可してください。許可しないと、ダッシュボードは正常に読み込まれる一方で、新しいメッセージが手動で更新するまで表示されない症状が発生します。
データベースを初期化してスタックを起動する
最初にデータサービスを起動し、Postgres の初回起動が完了するまで待ちます。
docker compose up -d postgres redis
docker compose logs postgres | tail -n 5database system is ready to accept connections になるまで待ちます。その後、スキーマを作成します。
docker compose run --rm rails bundle exec rails db:chatwoot_prepareこれにより、データベースが存在しない場合は作成され、その後にスキーマとデフォルトのシードデータが読み込まれます。マイグレーションの行が出力され、正常に終了します。postgres:5432 - no response を出力し続ける場合、エントリポイントはまだ接続を受け付けていないデータベースを待機しています。初回起動では、通常 initdb が処理中であることを意味します。待機して Postgres のログを確認し、その後もう一度実行します。vector 拡張機能の箇所で停止する場合は、pgvector イメージを標準の Postgres に置き換えています。
docker compose up -d
docker compose ps
docker compose logs --tail 30 rails4 つすべてのコンテナが Up になり、rails のログの末尾が http://0.0.0.0:3000 を待ち受ける Puma の行になっていることを確認します。次に、公開パスを確認します。
curl -sI https://support.example.com | head -n 1HTTP/2 200 であれば、チェーン全体が正常に動作しています。Traefik から 404 が返る場合は、ルーターのルールが一致していません。通常はホスト名の入力ミスが原因です。502 が返る場合は、Traefik がルーターに一致したものの、コンテナに接続できていません。ほとんどの場合、proxy ネットワークがないか、loadbalancer.server.port が 3000 ではありません。
URL を開き、/app/auth/signup でアカウントを作成します。その後、ENABLE_ACCOUNT_SIGNUP=false を設定し、docker compose up -d を実行してフォームを閉じます。
SMTP なしでパスワードリセットとメールのやり取りが失敗する理由
SMTP(simple mail transfer protocol)の設定がない Chatwoot はメールを送信できないため、通知以外の機能も壊れます。パスワードリセットが機能しなくなり、ロックアウトされた管理者はログインできないままです。エージェントへの招待も機能しません。招待はメールで送信されるためです。メールでの会話で顧客に返信することもできなくなり、会話が一方向になります。多くの人がこの手順を省略し、最も困る時期になって初めて問題に気付きます。
仕組みは単純です。SMTP_ADDRESS が設定されていない場合、Chatwoot は ActionMailer の送信方式を sendmail に切り替えます。Upstream のドキュメントでは、これは Postfix のセットアップとして説明されています。v2.12.0 以降のデフォルトであり、手順では sudo apt install -y postfix を使ってサーバーに Postfix をインストールします。この Docker 構成ではそれを行わないため、送信方式がメールを渡す設定済みのメールサーバーがありません。メール送信はバックグラウンドジョブから実行されるため、送信で発生したエラーは Sidekiq のログに記録され、Rails のログには記録されません。一方、「forgot password」をクリックした人には成功したような確認メッセージが表示されますが、メールは届きません。
MAILER_SENDER_EMAIL=Support <support@example.com>
SMTP_DOMAIN=example.com
SMTP_ADDRESS=smtp.example.com
SMTP_PORT=587
SMTP_USERNAME=support@example.com
SMTP_PASSWORD=<the relay password>
SMTP_AUTHENTICATION=plain
SMTP_ENABLE_STARTTLS_AUTO=trueSTARTTLS を使用する port 587 を使います。接続を平文で開始し、認証前に暗号化へ切り替える方式です。多くの VPS プロバイダーは、スパム対策として送信先 port 25 をデフォルトでブロックします。2026 年 11 月 8 日時点で、Hetzner は cloud server の port 25 と 465 をデフォルトでブロックしており、ブロックはアカウント単位で適用されます。Vultr はすべての新しい Compute Instance で port 25 をブロックしています。どちらもブロック解除の申請を個別に審査します。Hetzner では、申請する前に顧客として 1 か月経過し、最初の請求書を支払っている必要があります。どちらも 587 はブロックしないため、申請も待ち時間もなく、最初の起動時から 587 の relay を利用できます。SMTP_DOMAIN は SMTP のやり取りでサーバーが通知するドメインであり、一部の relay は不一致を拒否します。
設定を適用し、worker を監視します。
docker compose up -d rails sidekiq
docker compose logs -f sidekiqログインページからパスワードリセットを実行します。送信が正常に機能している場合、Sidekiq のログで mailer ジョブが正常に完了します。失敗すると、まず例外クラスが表示され、その後 Sidekiq が間隔を徐々に延ばしながら再試行します。そのため、壊れた relay では同じエラーが数時間にわたり数分おきに発生します。
よくある拒否は 2 つあり、どちらも Chatwoot のバグではありません。535 Authentication failed は認証に失敗したことを示します。認証情報、SMTP 認証が有効かどうか、アクセスポリシーによってブロックされていないかを確認してください。認証情報が正しいだけでは、このエラーが発生しないとは判断できません。プロバイダーによっては、アカウントのパスワードではなくアプリケーションパスワードが必要です。550 Sender address rejected はサーバーが送信者アドレスを拒否したことを示します。MAILER_SENDER_EMAIL を変更する前に、完全な応答を確認してください。送信者権限または検証が原因の 1 つですが、550 5.7.27 Sender address rejected: Domain does not accept mail は送信者ドメインに null MX レコードがあることを示します。
会話へのメール受信は別の処理です。Chatwoot の ingress を経由して転送するには、MAILER_INBOUND_EMAIL_DOMAIN と RAILS_INBOUND_EMAIL_SERVICE に加えて、受信メッセージを Chatwoot に渡すメールサーバーが必要です。転送経路を構成せずに、Google または Microsoft OAuth を含む IMAP でメールボックスに接続することもできます。relay を借りるのが最も早い方法です。メール経路全体を自分で管理する場合は、Mailcow で自分のメールサーバーを運用する で、その運用に実際に何が必要かを説明しています。
バックアップ対象とリストアの検証方法
Chatwoot のバックアップには 4 つの要素があります。どれか 1 つでも省くと、リストアではなく再構築になります。
- 会話、連絡先、エージェントアカウント、すべての設定を保持する Postgres データベース。
storage_dataボリューム。ACTIVE_STORAGE_SERVICE=localはアップロードファイルをディスクに書き込み、Postgres には参照行だけを保持するためです。.envファイル。SECRET_KEY_BASEとACTIVE_RECORD_ENCRYPTION_*のキーを保持するためです。- compose ファイル。データベーススキーマと一致する正確なイメージタグを記録しているためです。
データベースだけをリストアすると、すべての会話は戻りますが、添付ファイルは壊れます。行が、ディスク上に存在しなくなったファイルを指すためです。
cd ~/chatwoot
docker compose exec -T postgres pg_dump -U postgres -Fc chatwoot > db-$(date +%F).dump-T は重要です。これを指定しないと Compose が疑似端末を割り当て、ストリーム内の改行バイトを書き換えます。その結果、pg_restore が拒否するダンプファイルになります。-Fc はカスタム形式です。圧縮でき、pg_restore で選択的に処理できます。
docker run --rm -v chatwoot_storage_data:/data:ro -v "$PWD":/backup alpine \
tar czf /backup/storage-$(date +%F).tgz -C /data .ボリューム名は、プロジェクトディレクトリ名に _storage_data を加えたものです。コマンドを信頼する前に docker volume ls | grep storage_data で確認してください。存在しない名前を指定しても、Docker は失敗せず空のボリュームを作成するためです。有効な空のアーカイブが作成され、エラーも発生しません。作成後に ls -lh storage-*.tgz でサイズを確認してください。
これで両方のファイルが、保護対象と同じディスク上に置かれます。これでは何も保護できません。サーバー外へ転送して暗号化してください。データベースダンプには、すべての顧客メッセージが平文で含まれるためです。restic による暗号化したオフサイトバックアップでは、スケジュール設定と保持期間について説明しています。
必要になる前にリストア手順を実行する
稼働中の VPS ではなく、2 台目の VPS にリストアしてください。.env、compose ファイル、両方のアーカイブをコピーしてから、次を実行します。
docker compose up -d postgres
docker compose exec -T postgres pg_restore -U postgres -d chatwoot --clean --if-exists < db-2026-08-10.dump
docker run --rm -v chatwoot_storage_data:/data -v "$PWD":/backup alpine \
sh -c 'rm -rf /data/* && tar xzf /backup/storage-2026-08-10.tgz -C /data'
docker compose up -d--clean --if-exists は読み込み前に既存のオブジェクトを削除します。そのため、失ってもよいデータベースに対してだけ実行してください。次にサインインし、添付ファイルのある会話を開きます。メッセージ一覧が読み込まれ、ファイルをダウンロードできれば、バックアップは有効です。
異なる SECRET_KEY_BASE を使用してリストアすると、すべてのセッション Cookie が無効になり、全員がサインアウトされます。異なる ACTIVE_RECORD_ENCRYPTION_* キーを使用したリストアは、さらに深刻です。Chatwoot はチャネル認証情報を保持するカラムを復号できず、ActiveRecord::Encryption::Errors::Decryption を発生させます。そのため、.env がバックアップ対象に含まれています。
Chatwoot を新しい tag にアップグレードする方法
コマンドよりも、実行順序が重要です。
- 現在の tag から対象の tag までのリリースノートを読み、手動で必要な手順を確認します。
- 最新のデータベースダンプとストレージアーカイブを作成し、どちらもファイルサイズに問題がないことを確認します。
docker-compose.yamlのbaseサービスで image tag を編集します。- 新しい image を pull し、stack を停止して migration を実行し、その後もう一度起動します。
docker compose pull
docker compose down
docker compose run --rm rails bundle exec rails db:chatwoot_prepare
docker compose up -d
docker compose imagesmigration は新しい image から実行する必要があるため、先に pull します。古い image には新しい migration ファイルが含まれていません。migration の前に stack を停止します。古いコードと新しい schema は一致しないため、稼働中の古い Rails プロセスがエラーを発生させたり、新しい schema で受け付けられない行を書き込んだりする可能性があります。停止すると migration に必要なメモリも解放されます。これが upstream が swap を求める理由です。
docker compose images は、各 container が実際に実行している tag を表示します。tag を編集したものの pull を忘れた場合も検出できます。
どこまで一度に更新できるかは、現在の install がどれだけ古いかによって異なります。1 つか 2 つ前の release であれば、現在の tag から対象の tag までのリリースノートを確認し、対象の tag を設定して、上記の手順を 1 回実行します。install が非常に古い場合に限り、upstream の Docker ガイドでは最新の image に直接更新せず、中間の image tag を順番に経由して更新するよう案内しています。その場合は、中間の各 tag について tag の変更、pull、prepare の手順を繰り返します。upstream は各更新後に db:chatwoot_prepare を実行するよう求めています。
migration の実行前に Rails が起動すると、サービス提供を拒否し、ActiveRecord::PendingMigrationError: Migrations are pending をログに出力します。restart: always を設定すると、container は再起動を繰り返すため、docker compose ps には数秒ごとにリセットされる uptime が表示されます。prepare の手順を実行すると解消します。
ロールバックするには、古い tag に戻してダンプを復元します。信頼できる逆向きの migration 手順はありません。これが手順 2 を実行する理由です。
障害パターンと表示される文字列
Traefik からの 502 Bad Gateway。 ルーターは一致しましたが、バックエンドが応答していません。docker compose ps で rails が Up と表示されることを確認し、次に docker network inspect proxy を実行して、コンテナ一覧に rails コンテナが表示されることを確認します。接続されていないコンテナは Traefik から見えません。そのため、リクエストはルーターに一致しても、転送先がなくなります。
ダッシュボードは読み込まれるが、新しいメッセージの表示に更新が必要。 /cable への websocket 接続が通っていないか、FRONTEND_URL がブラウザーのアドレスバーに表示されているアドレスと一致していません。一致しない場合、ページは別の origin への websocket 接続を開こうとします。これはブラウザーによってブロックされます。
FATAL: password authentication failed for user "postgres"。 .env のパスワードと、Postgres のデータボリュームに保存されたパスワードが異なります。実行中のコンテナ内で ALTER USER を実行して修正します。.env を再度編集しても、初期化済みのデータベースは変更されません。
NOAUTH Authentication required. Redis は --requirepass で実行されていますが、アプリケーションはパスワードなしで接続しました。そのため、.env に REDIS_PASSWORD がないか、読み込まれていません。docker compose exec redis sh -c 'redis-cli -a "$REDIS_PASSWORD" ping' で Redis が直接パスワードを要求することをテストします。PONG と応答すれば成功です。シングルクォートは重要です。これにより、変数は自分の shell ではなく、.env を読み取るコンテナ内で展開されます。自分の shell では、通常、変数は空になります。
終了コード 137 でコンテナが終了する。 これは SIGKILL です。小規模なサーバーでは、通常は kernel の out of memory killer が送信元ですが、docker kill も同じシグナルを送信します。そのため、メモリが原因だと判断する前に sudo dmesg -T | grep -i "killed process" を確認してください。メモリが原因であれば、swap を追加するか、サービスごとのメモリ制限を設定するか、より大きなプランに移行します。
FAQ
自己ホスト型 Chatwoot VPS にはどれくらいの RAM が必要ですか?
2026 年 10 月時点で、upstream は最小構成として RAM 4 GB、CPU 4 コアを求めており、1 日最大 10,000 件の会話に対応できる構成としています。最大 20,000 件の場合は、RAM 8 GB、8 コアが必要です。少なくとも 1 GB の swap も追加してください。アップグレード時には migration を適用するために 2 つ目の Rails プロセスが起動し、小規模な VPS ではこの時点でメモリが不足するためです。RAM 2 GB の VPS でも起動して数人のエージェントで動作します。ただし、負荷がかかると Sidekiq だけで 1 GB を超えることがあります。そのため、繁忙期やアップグレード中にコンテナが exit code 137 で強制終了される可能性があります。
Chatwoot の password reset メールが届かないのはなぜですか?
SMTP_ADDRESS が設定されていないためです。Chatwoot は sendmail による配信へフォールバックします。upstream は、ホストに Postfix サーバーがインストールされている構成を想定していますが、この Docker 構成にはありません。ジョブは Sidekiq で実行されるため、配信エラーは Sidekiq のログに記録されます。一方、ブラウザーには成功メッセージが表示されます。.env に SMTP_ADDRESS、SMTP_PORT、SMTP_USERNAME、SMTP_PASSWORD、MAILER_SENDER_EMAIL を設定し、rails と sidekiq のサービスを再起動してください。その後、reset を実行しながら docker compose logs -f sidekiq を監視します。
Chatwoot を復元するには何をバックアップする必要がありますか?
Postgres データベース、storage_data Docker volume、.env ファイル、compose ファイルをバックアップします。データベースだけでは不十分です。アップロードされたファイルは volume に保存され、Postgres にはそれらへの参照だけが保存されるためです。データベースだけを復元すると、添付ファイルが壊れた会話が復元されます。.env も重要です。別の SECRET_KEY_BASE ではすべてのユーザーがサインアウトされ、別の ACTIVE_RECORD_ENCRYPTION_* では暗号化されたカラムを読み取れなくなるためです。
データベースを壊さずに Chatwoot をアップグレードするにはどうすればよいですか?
バックアップを取得し、現在の tag から対象の tag までの release notes を確認します。compose ファイルの image tag を変更し、docker compose pull、docker compose down、docker compose run --rm rails bundle exec rails db:chatwoot_prepare、docker compose up -d を実行します。migration は新しい image から実行する必要があるため、先に pull してください。古いコードが新しい schema にアクセスするとエラーになるため、先に stack を停止してください。非常に古い install だけは、最新の tag へ直接移行せず、中間の image tag を順に適用する必要があります。その場合は各 tag の後に prepare step を実行します。
pgvector の代わりに標準の postgres image を使用できますか?
いいえ。Chatwoot の schema では vector extension が有効になっています。そのため、標準の postgres image は db:chatwoot_prepare の実行中に ERROR: extension "vector" is not available で失敗します。この image には extension の control file が存在しないためです。upstream の compose file にある pgvector/pgvector:pg16 をそのまま使用するか、使用している Postgres major version 用の pgvector を提供する別の image を使用してください。