インストール方法
現在のバージョンはバックアップ・リストア形式でデプロイされます。今後のバージョンでは、既存のシステムにソリューションを統合しやすくするため、増分マイグレーション形式に変更される可能性があります。
バックアップマネージャープラグインはオープンソース化されました：ソリューションのリストアに必要な「バックアップマネージャー」プラグインはオープンソース化され、すべてのエディション（コミュニティ版を含む）で利用可能になりました。このプラグインを通じて直接リストアすることを推奨します。
開始する前に、以下を確認してください：
- すでに基礎となる NocoBase 実行環境があること。メインシステムのインストールについては、詳細な公式インストールドキュメントを参照してください。
- NocoBase バージョン v2.1.0-beta.2 以上
- CRM システムのバックアップファイルをダウンロード済みであること：nocobase_crm_v2_backup_260523.nbdata
重要事項：
- 本ソリューションは PostgreSQL 16 データベースに基づいて作成されています。環境で PostgreSQL 16 を使用していることを確認してください。
- DB_UNDERSCORED は true にしないでください：
docker-compose.ymlファイルを確認し、DB_UNDERSCORED環境変数がtrueに設定されていないことを確認してください。そうでない場合、ソリューションのバックアップと競合し、リストアに失敗します。
バックアップマネージャーを使用してリストア
この方法は、NocoBase 内蔵の「バックアップマネージャー」プラグインを使用してワンクリックでリストアを行うもので、操作が最も簡単です。このプラグインはオープンソース化され、すべてのエディション（コミュニティ版を含む）で利用可能になりました。
主な特徴
- メリット：
- 操作が便利：UI 画面で完結し、プラグインを含むすべての設定を完全にリストアできます。
- 完全なリストア：テンプレート印刷ファイルや、テーブル内のファイルフィールドでアップロードされたファイルなど、すべてのシステムファイルをリストア可能であり、機能の完全性を保証します。
- 制限事項：
- 環境要件が厳格：データベース環境（バージョン、大文字小文字の区別設定など）が、バックアップ作成時の環境と高度に互換性がある必要があります。
- プラグインの依存関係：ソリューションにローカル環境にない商用プラグインが含まれている場合、リストアは失敗します。
操作手順
ステップ 1：【強く推奨】 full イメージを使用してアプリケーションを起動する
データベースクライアントの欠如によるリストア失敗を避けるため、full バージョンの Docker イメージを使用することを強く推奨します。これには必要なすべての関連プログラムが内蔵されており、追加設定なしで使用できます。
イメージをプルするコマンド例：
その後、このイメージを使用して NocoBase サービスを起動します。
注：
fullイメージを使用しない場合、コンテナ内にpg_dumpデータベースクライアントを手動でインストールする必要があり、プロセスが煩雑で不安定になる可能性があります。
ステップ 2：「バックアップマネージャー」プラグインを有効にする
- NocoBase システムにログインします。
プラグイン管理に移動します。バックアップマネージャープラグインを見つけて有効にします。
ステップ 3：ローカルバックアップファイルからリストアする
- プラグインを有効にした後、ページを更新します。
- 左側メニューの
システム管理->バックアップマネージャーに移動します。 - 右上の
ローカルバックアップからリストアボタンをクリックします。 - ダウンロードしたバックアップファイルをアップロードエリアにドラッグ＆ドロップします。
送信をクリックし、システムがリストアを完了するまで待ちます。このプロセスには数十秒から数分かかる場合があります。
注意事項
- データベースの互換性：これはこの方法で最も重要な点です。PostgreSQL データベースのバージョン、文字セット、大文字小文字の区別設定がバックアップ元のファイルと一致している必要があります。特に
schema名は一致している必要があります。 - 商用プラグインの一致：ソリューションに必要なすべての商用プラグインを所有し、有効にしていることを確認してください。そうでない場合、リストアは中断されます。
よくある質問
プロフェッショナル版でも使えますか？エラーは出ませんか？
そのままご利用いただけます。エラーは発生しません。Demo では一部のエンタープライズ版プラグイン（メール管理、監査ログなど）が使用されて いますが、プロフェッショナル版でこれらのプラグインがない場合、対応する機能の入口は表示されません。ただし、システムの他の機能には影響しません。例えば、メールの入口は表示されなくなりますが、リード、商機、注文などのコアモジュールは完全に正常に動作します。
リストア後はどのバージョンを選べばよいですか？
最新の beta-full バージョンのイメージ（例：nocobase/nocobase:beta-full）の使用を推奨します。full イメージにはデータベースクライアントなどの依存関係が内蔵されており、リストア時にツール不足で失敗することを防ぎます。
リストア後にロゴが表示されません
公式 Demo のロゴにはドメイン制限が設定されているため、ローカルのドメインではロゴを読み込めません。システム設定に移動して、ご自身のロゴを再アップロードしてください。
増分アップグレードはどうすればよいですか？
現時点ではバージョンアップは全量置換となり、カスタム変更は上書きされます。アップグレード前には必ずバックアップを取ってください。増分マイグレーション方式は現在計画中で、プロフェッショナル/エンタープライズ版から優先的にサポートされる予定です。コミュニティ版はマイグレーション管理プラグインがないため、当面のサポートは困難な状況です。
このチュートリアルが CRM 2.0 システムの円滑なデプロイに役立つことを願っています。操作中に問題が発生した場合は、いつでもお気軽にお問い合わせください！
Last updated: 2026-04-02