Difyをローカルにセットアップしてみよう

Difyをローカルにセットアップする手順をご案内します

Dify は LangGenius, Inc. が開発・公開している OSS（オープンソース）の Web アプリケーションです。
その OSS を自分のマシン上で動かしてみましょう。

実体は何か？

Dify は「サービス」ではなく、ソフトウェア一式です。

中身はこうなっています：

• Backend：Python（FastAPI）
• Frontend：React / Next.js
• 実行環境：Docker コンテナ
• 付属コンポーネント
  • PostgreSQL（設定・履歴保存）
  • Redis（セッション・キュー）
  • Vector DB（Qdrant / Weaviate など）

つまり、
Dify = Webアプリ + DB + Redis + VectorDB
それを Docker Compose でまとめて起動しているといった構造です。

　1. Docker
　2. Dify
　の順でセットアップを進めていきます。

1.Dockerインストール状態確認

• Windowsの場合

  • 検索にdockerと入力し、↓の「docker desktop」 があればOK！
    

• Linuxの場合

  • コマンドでDockerが入っているか確認

spark-ff00:~$ docker --version
Docker version 28.5.1, build e180ab8
spark-ff00:~$ docker compose version
Docker Compose version v2.40.0
spark-ff00:~$

2.Dockerインストール

Dockerがまだ入っていないリンクから手順を実施してください。

• Windowsの場合

Docker(Linux)インストール案内リンク

• Linuxの場合

Docker(Linux)インストール案内リンク

1.

spark-ff00$ sudo apt update
[sudo] パスワード:
ヒット:1 https://repo.download.nvidia.com/baseos/ubuntu/noble/arm64 noble InRelease
ヒット:2 https://workbench.download.nvidia.com/stable/linux/debian default InRelease
取得:3 https://download.docker.com/linux/ubuntu noble InRelease [48.5 kB]
...
16.9 MB を 5秒 で取得しました (3,690 kB/s)
パッケージリストを読み込んでいます... 完了
依存関係ツリーを作成しています... 完了
状態情報を読み取っています... 完了

2.

spark-ff00$ sudo apt install -y ca-certificates curl gnupg lsb-release
パッケージリストを読み込んでいます... 完了
依存関係ツリーを作成しています... 完了
状態情報を読み取っています... 完了
ca-certificates はすでに最新バージョン (20240203) です。
curl はすでに最新バージョン (8.5.0-2ubuntu10.6) です。
gnupg はすでに最新バージョン (2.4.4-2ubuntu17.3) です。
lsb-release はすでに最新バージョン (12.0-2) です。
lsb-release は手動でインストールしたと設定されました。
アップグレード: 0 個、新規インストール: 0 個、削除: 0 個、保留: 33 個。
spark-ff00$

3.

spark-ff00$ dir /etc/apt/keyrings
docker.gpg
spark-ff00$ apt list --upgradable
一覧表示... 完了
apparmor/noble-updates 4.0.1really4.0.1-0ubuntu0.24.04.5 arm64 [4.0.1really4.0.1-0ubuntu0.24.04.4 からアップグレード可]
binutils-aarch64-linux-gnu/noble-updates,noble-security 2.42-4ubuntu2.8 arm64 [2.42-4ubuntu2.7 からアップグレード可]
...
spark-ff00$

4.

spark-ff00$ sudo mkdir -p /etc/apt/keyrings
[sudo]   のパスワード:
spark-ff00$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
 | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
spark-ff00$

5.

spark-ff00$ echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) stable" \
| sudo tee /etc/apt/sources.list.d/docker.list
deb [arch=arm64 signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu noble stable
spark-ff00$ sudo apt update
取得:1 https://download.docker.com/linux/ubuntu noble InRelease [48.5 kB]
ヒット:2 https://repo.download.nvidia.com/baseos/ubuntu/noble/arm64 noble InRelease
ヒット:3 https://workbench.download.nvidia.com/stable/linux/debian default InRelease
...
89.1 kB を 2秒 で取得しました (40.1 kB/s)
パッケージリストを読み込んでいます... 完了
依存関係ツリーを作成しています... 完了
状態情報を読み取っています... 完了
アップグレードできるパッケージが 33 個あります。表示するには 'apt list --upgradable' を実行してください。
spark-ff00$
spark-ff00$ sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
パッケージリストを読み込んでいます... 完了
依存関係ツリーを作成しています... 完了
状態情報を読み取っています... 完了
docker-ce はすでに最新バージョン (5:28.5.1-1~ubuntu.24.04~noble) です。
docker-ce は手動でインストールしたと設定されました。
docker-ce-cli はすでに最新バージョン (5:28.5.1-1~ubuntu.24.04~noble) です。
docker-ce-cli は手動でインストールしたと設定されました。
containerd.io はすでに最新バージョン (1.7.28-1~ubuntu.24.04~noble) です。
containerd.io は手動でインストールしたと設定されました。
docker-compose-plugin はすでに最新バージョン (2.40.0-1~ubuntu.24.04~noble) です。
アップグレード: 0 個、新規インストール: 0 個、削除: 0 個、保留: 33 個。
spark-ff00$ sudo usermod -aG docker $USER
spark-ff00$ newgrp docker
spark-ff00$

• 3.Difyインストール

• Windowsの場合

Git公式サイトにアクセスし、「Download for Windows」ダウンロード
https://gitforwindows.org/

DifyのGitHubリポジトリをクローン

>git clone https://github.com/langgenius/dify.git

1.Docker Desktopを起動します

2.コマンドプロンプトでdockerフォルダに移動

>cd dify/docker

3.環境設定ファイルをコピー

>copy .env.example .env

4.Dockerコンテナを起動

\docker>docker compose up -d
[+] Running 11/11
 ✔ Container docker-redis-1          Running  0.0s
 ✔ Container docker-weaviate-1       Running  0.0s
 ✔ Container docker-ssrf_proxy-1     Running  0.0s
 ✔ Container docker-web-1            Running  0.0s
 ✔ Container docker-db-1             Healthy  0.6s
 ✔ Container docker-sandbox-1        Running  0.0s
 ✔ Container docker-plugin_daemon-1  Running  0.0s
 ✔ Container docker-worker-1         Running  0.0s
 ✔ Container docker-api-1            Running  0.0s
 ✔ Container docker-worker_beat-1    Running  0.0s
 ✔ Container docker-nginx-1          Running  0.0s
\docker>

※RunningになっていればOK

5..ブラウザでアクセス

http://localhost/install

6.ブラウザでアクセスできていること
以下の画面が表示されればDifyのインストールは完了です

• Linuxの場合

1.Difyをダウンロード

spark-ff00:~/docker$ git clone https://github.com/langgenius/dify.git
Cloning into 'dify'...
remote: Enumerating objects: 266697, done.
remote: Counting objects: 100% (558/558), done.
remote: Compressing objects: 100% (274/274), done.
remote: Total 266697 (delta 441), reused 284 (delta 284), pack-reused 266139 (from 3)
Receiving objects: 100% (266697/266697), 177.69 MiB | 13.89 MiB/s, done.
Resolving deltas: 100% (194149/194149), done.
spark-ff00:~/docker$ cd docker/dify
spark-ff00:~/docker/dify$

2.ランダム鍵の作成

spark-ff00:~/docker/dify$ openssl rand -base64 42
+cqT7vJnRahppxnJOhmGUkdbyh0MyDiROwo3qZwLw5n+6AABCDEABCDE
spark-ff00:~/docker/dify$

※出てきた文字列をコピーします

3.環境変数ファイル作成

spark-ff00:~ /docker$ cp .env.example .env
spark-ff00:~ /docker$
spark-ff00:~ /docker$ nano .env

4.[.env]変更👇

# セキュリティ
SECRET_KEY=+cqT7vJnRahppxnJOhmGUkdbyh0MyDiROwo3qZwLw5n+6AABCDEABCDE

※先ほどの文字列を貼り付け

5.設定内容確認

spark-ff00:~/docker/dify$ more .env | grep SECRET_KEY=
SECRET_KEY=+cqT7vJnRahppxnJOhmGUkdbyh0MyDiROwo3qZwLw5n+6AABCDEABCDE

編集が反映されていればOK

6.Difyを起動する

docker compose up -d

7.状態確認

docker compose ps

8.ブラウザでアクセス

http://localhost/install

9.ブラウザでアクセスできていること
以下の画面が表示されればDifyのインストールは完了です

お疲れさまでした！
次は、Difyの初期設定を案内します。