Installation

Diverge provides a single consolidated Docker image containing both the controller and the proxy components. The image is built on a distroless nonroot base for enhanced security. You can select which component to run using the Kubernetes command.

Helm Chart

The recommended way to install Diverge is using the official Helm chart:

helm install diverge oci://ghcr.io/divergedev/charts/diverge --namespace diverge-system --create-namespace

Deploying the ConnectRPC Server

To enable the ConnectRPC server for API access without kubectl, configure your values.yaml:

server:
  enabled: true

Then upgrade or install the chart:

helm upgrade --install diverge oci://ghcr.io/divergedev/charts/diverge \
  --namespace diverge-system \
  --create-namespace \
  -f values.yaml

Script Download

You can quickly install the latest Diverge CLI using our install script:

curl -fsSL https://divergedev.com/install.sh | sh

If you prefer to inspect the script before executing, the following displays the digest for manual comparison against the release notes:

curl -fsSL -o install.sh https://raw.githubusercontent.com/divergedev/diverge/v0.10.0/install.sh
sha256sum install.sh
# Compare the output above against the digest published in the GitHub release notes
sh install.sh

Binary Download

Download the Diverge CLI from GitHub Releases.

Docker Image

The Docker image is available on GitHub Container Registry:

docker pull ghcr.io/divergedev/diverge:latest

Diverge is built using Go 1.26.