| --- |
| title: Dify |
| emoji: 🐢 |
| colorFrom: gray |
| colorTo: red |
| sdk: docker |
| pinned: false |
| --- |
| |
| # Dify on HuggingFace Spaces |
|
|
| Self-hosted [Dify](https://dify.ai) (v1.14.2) running as a single Docker container on HuggingFace Spaces. |
|
|
| ## Setup |
|
|
| 1. Enable **Persistent Storage** in your Space settings (Settings → Persistent storage). This mounts `/data` and preserves your database, uploads, and configuration across container restarts. |
|
|
| 2. Set the following **Secrets** in your Space settings for security: |
| - `SECRET_KEY` — a random string (generate with `openssl rand -base64 42`) |
| - `INIT_PASSWORD` — admin account initial password |
|
|
| 3. The Space will build and deploy automatically. First boot takes a few minutes to initialize the database. |
|
|
| ## Default Credentials |
|
|
| - URL: `https://<your-space>.hf.space` |
| - Initial admin password: `dify123456` (change via `INIT_PASSWORD` secret) |
|
|
| ## Architecture |
|
|
| Single container running via supervisord: |
| - **PostgreSQL 15** — application database (data at `/data/postgres`) |
| - **Redis** — cache and Celery broker (data at `/data/redis`) |
| - **Dify API** — Flask/Gunicorn on port 5001 |
| - **Dify Worker** — Celery async worker |
| - **Dify Web** — Next.js frontend on port 3000 |
| - **Nginx** — reverse proxy on port 7860 (HF Spaces ingress port) |
|
|
| File uploads stored at `/data/storage`. |
|
|
| ## Configuration |
|
|
| Override any Dify environment variable via HuggingFace Space Secrets or Variables. Common ones: |
| - `SECRET_KEY`, `INIT_PASSWORD` |
| - `LOG_LEVEL` (default: INFO) |
| - `STORAGE_TYPE` (default: local) |
|
|
