インストール方法

現在のバージョンはバックアップ・復元形式でデプロイされます。今後のバージョンでは、既存のシステムにソリューションを統合しやすくするために、増分移行形式に変更される可能性があります。

バックアップマネージャープラグインはオープンソース化されました：ソリューションの復元に必要な「バックアップマネージャー」プラグインはオープンソース化され、すべてのエディション（コミュニティ版を含む）で利用可能になりました。このプラグインを通じて直接復元することを推奨します。

開始する前に、以下を確認してください：

重要事項：

本ソリューションは PostgreSQL 16 データベースに基づいて作成されています。環境で PostgreSQL 16 を使用していることを確認してください。
DB_UNDERSCORED は true にできません：docker-compose.yml ファイルを確認し、DB_UNDERSCORED 環境変数が true に設定されていないことを確認してください。そうでない場合、ソリューションのバックアップと競合し、復元に失敗します。

バックアップマネージャーを使用して復元

この方法は、NocoBase 内蔵の「バックアップマネージャー」プラグインを使用してワンクリックで復元する、最も簡単な操作です。このプラグインはオープンソース化され、すべてのエディション（コミュニティ版を含む）で利用可能になりました。

メリット：
1. 操作が簡単：UI 画面で完了でき、プラグインを含むすべての設定を完全に復元できます。
2. 完全な復元：テンプレート印刷ファイル、テーブル内のファイルフィールドでアップロードされたファイルなど、すべてのシステムファイルを復元可能であり、機能の完全性を保証します。
制限事項：
1. 環境要件が厳格：データベース環境（バージョン、大文字小文字の区別設定など）が、バックアップ作成時の環境と高度に互換性がある必要があります。
2. プラグインへの依存：ソリューションにローカル環境にない商用プラグインが含まれている場合、復元は失敗します。

ステップ 1：【強く推奨】full イメージを使用してアプリケーションを起動する

データベースクライアントの欠如による復元失敗を避けるため、full バージョンの Docker イメージを使用することを強くお勧めします。これには必要なすべての付属プログラムが含まれており、追加設定は不要です。

イメージ取得のコマンド例：

docker pull nocobase/nocobase:beta-full

その後、このイメージを使用して NocoBase サービスを起動します。

注：full イメージを使用しない場合、コンテナ内に pg_dump データベースクライアントを手動でインストールする必要があり、プロセスが煩雑で不安定になる可能性があります。

ステップ 2：「バックアップマネージャー」プラグインを有効にする

ステップ 3：ローカルのバックアップファイルから復元する

データベースの互換性：これがこの方法で最も重要な点です。PostgreSQL データベースのバージョン、文字セット、大文字小文字の区別設定がバックアップ元のファイルと一致している必要があります。特に schema 名は一致している必要があります。
商用プラグインの一致：ソリューションに必要なすべての商用プラグインを所有し、有効にしていることを確認してください。そうでない場合、復元は中断されます。

Last updated: 2026-03-24