Skip to main content

このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版 を参照してください。

Tip

一般的なデプロイの問題は FAQ を参照してください。

デプロイ前の準備#

マシンが以下の最小システム要件を満たしているか確認してください。

ハードウェア#

  • CPU >= 2 コア
  • RAM >= 4 GiB

ソフトウェア#

オペレーティングシステム必要なソフトウェア備考
macOS 10.14 以降Docker Desktop / Docker Compose 2.24.0+2 vCPU 以上、8 GiB 以上のメモリを割り当てます。

Mac 用 Docker Desktop のインストール を参照してください。
LinuxDocker 19.03+ / Docker Compose 2.24.0+手順は以下を参照してください。

Docker Engine のインストール / Docker Compose のインストール
Windows (WSL 2)Docker Desktop / Docker Compose 2.24.0+ソースコードとデータは Linux ファイルシステムに保存。

Windows 用 Docker Desktop のインストール を参照してください。

デプロイと起動#

Dify をクローン

Dify のソースコードをローカルマシンにクローンします。

Info

このコマンドには git、curl、jq が必要です。command not found エラーが表示された場合は、不足しているツールをインストールしてから再実行してください。

クローンが fatal: Remote branch null not found in upstream origin エラーで失敗したときは、Dify releases で最新バージョンを確認し、バージョンを明示して再実行してください:

詳細は クローン時の「Remote branch null not found」エラー を参照してください。

Dify を起動

  1. Dify ソースコード内の docker ディレクトリに移動します:

  2. 必須の環境設定ファイルをコピーします:

    後でデプロイをカスタマイズする場合は カスタマイズ を参照してください。

  3. コンテナを起動します:

    Note

    Dify は Docker Compose 2.24.0 以降を必要とします。docker compose version を実行してバージョンを確認してください。

    以下のコンテナが起動します:

    • 7 つのコアサービス:api、api_websocket、worker、worker_beat、web、plugin_daemon、agent_backend
    • 8 つの依存コンポーネント:weaviate、db_postgres、redis、nginx、ssrf_proxy、agent_ssrf_proxy、sandbox、local_sandbox
    • 1 つの一時タスク:init_permissions(ストレージのファイル権限を設定し、完了後に終了します)
  4. すべてのコンテナが正常に動作しているか確認します:

    各コンテナのステータスが Up または healthy になっていれば正常です。init_permissions が Exited になっているのは想定どおりです。

アクセス#

  1. 管理者初期化ページを開いて、管理者アカウントを設定します:

  2. 管理者アカウントの設定が完了したら、以下のアドレスで Dify にログインします:

カスタマイズ#

デプロイをカスタマイズするには、関連するファイルの環境変数を編集してから Dify を再起動します。

環境変数を編集

  • 必須の起動値 は docker/.env にあります(デプロイ時に docker/.env.example からコピーして作成したファイル)。直接編集します。

  • オプションまたはプロバイダー固有の設定 は docker/envs/ にテンプレートとして用意されています。デフォルト値を上書きするには、対応するテンプレートをコピーし(.example 拡張子を外す)、コピーを編集します。

    例:

docker/.env の値は、docker/envs/*.env ファイルの値より優先されます。

Tip

すべての変数の説明は 環境変数 を参照してください。

Dify を再起動

アップグレード#

アップグレード手順はリリースによって異なる場合があります。Releases ページで提供されている対象バージョンのアップグレードガイドを参照してください。

Note

アップグレード後、各 .env.example を対応する .env と比較し、新規または変更された変数を確認してください。

docker-compose.yaml をカスタマイズしている場合は、古いファイルを使い続けるのではなく、新しいリリースのファイルにカスタマイズを適用し直してください。リリースによっては、Dify の動作に必要なサービスが追加されることがあります。