Dify for Cloudron

This is a Cloudron package for Dify, an open-source LLM app development platform.

Architecture

This package runs multiple Dify services within a single container using supervisord:

• API Server: Python/Flask (Port 5001)
• Web Frontend: Next.js (Port 3000)
• Worker: Celery worker for background tasks
• Beat: Celery scheduler
• Sandbox: Go-based sandbox service (DISABLED due to technical limitations)
• Plugin Daemon: Go-based plugin manager (Port 5002)

Limitations

"Code" Nodes Disabled

The Sandbox service (dify-sandbox) is currently disabled in this package. This means that "Code" nodes (Python/JavaScript execution blocks) in workflows will not function.

• Reason: The sandbox service's initialization logic attempts to perform recursive file operations that are incompatible with Cloudron's read-only file system architecture, causing the application to hang.
• Impact: You cannot use custom code execution blocks. All other features (Chat, RAG, Knowledge Base, Plugins) are fully functional.
• Nginx: Reverse proxy to route traffic to appropriate services

Data Persistence

• Application code is read-only in /app/code.
• All persistent data is stored in /app/data.
• Configuration files are generated in /app/data/config and /app/data/api-env.
• Uploaded files are in /app/data/storage.
• Plugin data is in /app/data/plugin_storage.

Development

Installation

This is a Community App which you can install through the Cloudron web interface.

Environment Variables

The start.sh script automatically generates the .env configuration for Dify based on Cloudron's environment variables (PostgreSQL, Redis, etc.).

Key files:

• start.sh: Entrypoint script that sets up environment and permissions.
• supervisord.conf: Process manager configuration.
• nginx.conf: Nginx configuration for routing requests.
• Dockerfile: Multi-stage build definition.

License

This package is licensed under the MIT License. Dify itself is licensed under the Apache 2.0 License.