Before starting the deployment, please ensure the following resources are prepared.

Requirements

  • Helm 3.14+
  • Kubernetes 1.24+
    1. Important For the License Activation, contact your IT team to provide the necessary permissions.
      • ServiceAccount (Required)
      • Role / RoleBinding (Required)
    2. Important Kubernetes cluster must support CRDs (Custom Resource Definitions).
    3. Important Kubernetes cluster must be able to connect to https://marketplace.dify.ai/.
    4. Warning If you are using a restricted environment, please make sure to allow the pods to run as root (like OpenShift).
  • Supported Cloud Providers
    • AWS, Azure, Aliyun, Tencent Cloud, GCP
  • Supported Container Registries
    • AWS ECR(with AK/SK or IRSA)/ Azure ACR / Aliyun ACR (with AK/SK) / Tencent TCR (with AK/SK) / Dockerhub / Google Artifact Registry
  • Supported Persistent Storage
    • S3 / AWS S3 (with AK/SK or IRSA) / Azure Blob / Aliyun OSS (with AK/SK) / Tencent COS (with AK/SK) / Google GCS

Domains

Dify Enterprise requires the following five domains to be configured:
PurposeDomain
Consoleconsole.dify.local
Services APIapi.dify.local
Web Appapp.dify.local
File Uploadupload.dify.local
Enterprise Dashboardenterprise.dify.local

Testing Deployment Resources

  • Kubernetes Cluster
    • 1 Worker Node: 4 CPU, 16 GB RAM
  • Container Registry (Plugins)
    • AWS ECR(with AK/SK or IRSA)/ Azure ACR / Aliyun ACR (with AK/SK) / Tencent TCR (with AK/SK) / Dockerhub / Google Artifact Registry
  • Persistence Storage
    • S3 / AWS S3 (with AK/SK or IRSA) / Azure Blob / Aliyun OSS (with AK/SK) / Tencent COS (with AK/SK) / Google GCS
    • 100 GB Storage
  • Postgres Database
    • Version 14+
    • 2 CPU, 4 GB RAM
    • 256 GB Storage
  • Redis Database
    • Version 6+
    • 1 GB RAM
  • Vector DB Virtual Machine - Qdrant Single Node
    • 1 Virtual Machines
    • 4 CPU, 8 GB RAM
    • 100 GB Storage

Production Deployment Resources

  • Kubernetes Cluster
    • 6 Worker Nodes: Each one 8 CPU, 32 GB RAM
  • Container Registry (Plugins)
    • AWS ECR(with AK/SK or IRSA)/ Azure ACR / Aliyun ACR (with AK/SK) / Tencent TCR (with AK/SK) / Dockerhub / Google Artifact Registry
  • Persistence Storage
    • S3 / AWS S3 (with AK/SK or IRSA) / Azure Blob / Aliyun OSS (with AK/SK) / Tencent COS (with AK/SK) / Google GCS
    • 512 GB Storage
  • Postgres Database
    • Version 14+
    • 4 CPU, 8 GB RAM
    • 512 GB SSD Storage
  • Redis Database
    • Version 6+
    • 2 GB RAM
  • Vector DB Virtual Machine - Qdrant Cluster
    • 3 Virtual Machines
    • 8 CPU, 64 GB RAM
    • 100 GB Storage