Enterprise docs

Dele Enterprise deployment guide

Prepare image access and license materials, then install Dele Enterprise with Docker Compose or Kubernetes. After startup, activate the license and configure company login in the admin console.

1. Installation options

Choose one installation path. Docker Compose is the fastest path for a single server. Kubernetes is for environments that already run on a company platform.

Docker Compose

Run the Compose installer on the target server. You do not need the source code repository.

Install
curl -fsSL https://www.dele.fun/install-enterprise.sh | bash

Compose checklist

  • Docker and Docker Compose are installed on the target server.
  • The server can pull the Dele Enterprise images from Docker Hub or your internal registry.
  • You have the License Key and license verification secret from Dele delivery.
  • You know the initial administrator email and enterprise access URL.

The installer automatically

  • Creates a deployment directory.
  • Reads docker-compose.enterprise.yml and the environment template from the Enterprise image.
  • Generates strong local secrets and writes .env.enterprise outside the container.
  • Starts the Web, Agent, database, and object storage services.

If your company uses an internal image registry, pass the image addresses when running the installer:

Private registry
curl -fsSL https://www.dele.fun/install-enterprise.sh | \
  DELE_ENTERPRISE_WEB_IMAGE=registry.company.com/dele:enterprise-v1.2.3 \
  DELE_ENTERPRISE_AGENT_IMAGE=registry.company.com/dele-agent:enterprise-v1.2.3 \
  bash

For non-interactive installation, pass the required values before bash:

Non-interactive
curl -fsSL https://www.dele.fun/install-enterprise.sh | \
  NEXTAUTH_URL=https://dele.company.internal \
  ADMIN_EMAILS=admin@company.com \
  DELE_LICENSE_SIGNING_SECRET=xxxx \
  bash

Kubernetes / Helm

Use Kubernetes when Dele Enterprise will run on your company platform. The installer only needs kubectl access to the target cluster. It downloads the Dele Helm chart from dele.fun and uses a temporary Helm binary if Helm is not installed.

Kubernetes install
curl -fsSL https://www.dele.fun/install-enterprise-k8s.sh | bash
  • No local Docker command is required.
  • No preinstalled Helm command is required.
  • Prepare a domain, PostgreSQL, object storage, and image registry access.
  • Expose only the Web service to users. Agent Runner stays inside the cluster.

2. Activate license

After the command finishes, open License Admin on your company instance URL, sign in with the administrator email, and paste the License Key.

/license-admin
https://dele.company.internal/license-admin

3. Configure login

In Login Settings, configure the company login method. LDAP / AD is managed in the admin UI after the instance starts. Feishu can be enabled through the deployment environment when needed.

4. Operate and upgrade

  • Do not edit files inside the container. Runtime configuration lives in .env.enterprise.
  • To upgrade, update image tags if Dele delivery provided pinned tags, then pull and restart the services.
  • Keep .env.enterprise during upgrades unless the delivery notes explicitly require a template update.
Upgrade
docker compose -f docker-compose.enterprise.yml --env-file .env.enterprise pull
docker compose -f docker-compose.enterprise.yml --env-file .env.enterprise up -d

5. Troubleshooting

  • If the installer says Docker Compose is missing, install Docker Compose on the target server first.
  • If license activation fails with INVALID_SIGNATURE, confirm the license verification secret matches the one from Dele delivery.
  • If the page opens but login fails, confirm the enterprise access URL matches the address users open in the browser.