Difyをローカルソースコードから起動！開発環境構築ガイド

Dify（ディファイ）をDocker Composeではなく、ソースコードから直接ビルドして起動する方法は、Dify自体のカスタマイズやデバッグを行いたい開発者にとって必須のスキルです。

この記事では、macOSやLinux環境を前提に、PythonバックエンドとNext.jsフロントエンドをセットアップし、ローカル環境でDifyを完全動作させるまでの手順をステップバイステップで解説します。

1. 前提条件と環境準備

ソースコードからの起動には、以下のミドルウェアとランタイムが必要です。

• OS: macOS 10.14+ または Linux (Ubuntu等)
• Docker & Docker Compose: データベース等のミドルウェア起動に使用
• Python: バージョン 3.12
• Node.js: バージョン 22 (LTS)
• システム要件: CPU 2コア以上、RAM 4GB以上推奨

リポジトリのクローン

まず、GitHubからDifyのソースコードをローカルにダウンロードします。

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

2. ミドルウェアの起動 (Docker Compose)

Dify本体はソースコードから動かしますが、PostgreSQL、Redis、Weaviateなどの依存ミドルウェアはDockerで起動するのが効率的です。

cd docker 
cp middleware.env.example middleware.env 
docker compose -f docker-compose.middleware.yaml up -d

これで、ポート5432（DB）や6379（Redis）などが利用可能になります。

3. バックエンド (API/Worker) のセットアップ

Difyの頭脳となるバックエンドサービスをPythonで立ち上げます。

Python環境の構築

推奨されるPythonバージョン管理ツール pyenv などを使って、Python 3.12環境を用意してください。

# apiディレクトリへ移動 cd ../api

環境変数の設定
cp .env.example .env

シークレットキーの生成と設定 (Mac/Linux)
awk -v key="$(openssl rand -base64 42)" '/^SECRET_KEY=/ {sub(/=.*/, "=" key)} 1' .env > temp_env && mv temp_env .env

依存関係のインストールとDB移行

Difyはパッケージ管理に高速な uv を採用しています。

# uvで依存パッケージをインストール 
uv sync

データベースのマイグレーション（テーブル作成など）
uv run flask db upgrade

APIサーバーの起動

uv run flask run --host 0.0.0.0 --port=5001 --debug

正常に起動すると Running on http://127.0.0.1:5001 と表示されます。

Workerサービスの起動

非同期処理（ドキュメントの解析やメール送信など）を行うWorkerを別ターミナルで起動します。

# apiディレクトリで実行 
uv run celery -A app.celery worker -P gevent -c 1 --loglevel INFO -Q dataset,generation,mail,ops_trace

4. フロントエンド (Web) のセットアップ

ユーザーインターフェースとなるWebサービスをNode.jsで立ち上げます。

依存関係のインストール

# webディレクトリへ移動 cd ../web

パッケージのインストール
pnpm install --frozen-lockfile

Note: pnpm がインストールされていない場合は npm i -g pnpm でインストールしてください。

環境変数の設定と起動

# 環境変数ファイルの作成 
cp .env.example .env.local

Webサーバーの起動（開発モード）
pnpm start

ビルドが完了すると Ready in ...ms と表示され、http://localhost:3000 でアクセス可能になります。

5. 動作確認

ブラウザで http://127.0.0.1:3000 にアクセスしてください。

Difyのセットアップ画面（管理者アカウント作成画面）が表示されれば、環境構築は成功です。

これで、Difyのソースコードを自由に修正し、即座に反映を確認できる開発環境が整いました。

【推奨】業務システム化に有効なアイテム

生成AIを学ぶ

起業のためのシステム化

45歳からの生成AI！ライフシフトラボで「稼ぐ力」を習得 – 起業のためのシステム化 40代〜60代特化！知識ゼロから3ヶ月で「稼げるAIスキル」を習得するライフシフトラボ。経験×AIで起業・副業を加速させましょう。無料説明会受付中。

起業のためのシステム化

AIで稼ぐ力を最短習得！僕のAIアカデミーで副業・起業へ – 起業のためのシステム化 スキルゼロからAIで稼ぐ力を身につける「僕のAIアカデミー」。ChatGPTや画像生成を学び、最短1ヶ月で収益化を目指す実践型スクールを解説します。

起業のためのシステム化

デジハクでAIを仕事に！未経験からプロを目指すマンツーマン講座 – 起業のためのシステム化 未経験からAIスキルで稼ぐ力をつけるオンラインスクール「デジハク」。マンツーマン指導と充実のアフターサポートで、副業・フリーランスへの道を最短で切り拓きます。

システム化のパートナー

ミラーマスター合同会社｜千葉のDX…

Dify自己ホスト型AIチャットボット導入支援 – ミラーマスター合同会社｜千葉のDX・システム開発とデジタル… 中小企業の属人化・問い合わせ対応をAIで自動化。セキュアなDify自己ホスト型チャットボット導入を10万円で専門家が支援。

ミラーマスター合同会社｜千葉のDX…

【製造業向け】業務改善・DX支援コンサル – ミラーマスター合同会社｜千葉のDX・システム開発とデジタル事… 製造業の経営者様へ。生産性向上・コスト削減を実現。40年の現場経験を持つ専門家が貴社のDXを伴走支援します。

ミラーマスター合同会社｜千葉のDX…

中小企業のシステム開発伴走支援 – ミラーマスター合同会社｜千葉のDX・システム開発とデジタル事業創造 「誰に頼めば…」とお悩みの中小企業様へ。40年の経験を持つ代表が貴社の開発プロジェクトを成功に導きます。全国対応。

VPSサーバの選定

起業のためのシステム化

Difyに最適なVPS比較 XServer vs ConoHa DifyでAI構築！XServer VPSとConoHa VPSを徹底比較。初心者におすすめの料金、簡単さ、スペックを解説します。

起業のためのシステム化

エックスサーバーのおすすめは？WordPress・VPS比較 国内シェアNo.1「エックスサーバー」のおすすめは？WordPressからVPS、法人利用まで、目的別に最適なプランを徹底解説。

起業のためのシステム化

ConoHaのおすすめは？WINGとVPSを徹底比較 ConoHaのおすすめは？WordPress(WING)、AI(VPS)、FXなど目的別に全サービスを比較。最適なプランが見つかります。