Installation

Install the Dorgu Operator via Helm, kustomize, or source build

Prerequisites

• Kubernetes cluster 1.24+
• kubectl configured for your cluster
• Helm 3.x (for Helm installation)

Helm (recommended)

Install the operator from the OCI registry:

helm install dorgu-operator oci://ghcr.io/dorgu-ai/dorgu-operator-charts/dorgu-operator \
  --version 0.7.2 \
  --namespace dorgu-system \
  --create-namespace

This page pins an exact chart version for reproducibility. Check operator releases for the newest chart, or omit --version to always install the latest.

To customize the installation, create a values.yaml file:

webhook:
  enabled: true
  mode: advisory

argocd:
  enabled: true

prometheus:
  enabled: true
  url: "http://prometheus-server.monitoring:9090"

websocket:
  enabled: true

Then install with your values:

helm install dorgu-operator oci://ghcr.io/dorgu-ai/dorgu-operator-charts/dorgu-operator \
  --version 0.7.2 \
  --namespace dorgu-system \
  --create-namespace \
  -f values.yaml

See the Helm values reference for all available options.

Kustomize

Install CRDs and deploy the operator using kustomize:

# Clone the repository
git clone https://github.com/dorgu-ai/dorgu-operator.git
cd dorgu-operator

# Install CRDs
make install

# Deploy the operator
make deploy IMG=ghcr.io/dorgu-ai/dorgu-operator:0.7.2

To uninstall:

make undeploy
make uninstall

Build from source

git clone https://github.com/dorgu-ai/dorgu-operator.git
cd dorgu-operator

# Build the binary
make build

# Run locally against your current kubeconfig
./bin/manager \
  --metrics-bind-address :8080 \
  --metrics-secure=false \
  --health-probe-bind-address :8081

Running locally connects to whatever cluster your kubeconfig points to. Make sure you are targeting the correct cluster before starting the operator.

Build and push Docker image

make docker-build IMG=your-registry/dorgu-operator:latest
make docker-push IMG=your-registry/dorgu-operator:latest

Multi-platform builds (arm64, amd64) are supported:

make docker-buildx IMG=your-registry/dorgu-operator:latest PLATFORMS=linux/arm64,linux/amd64

Verify installation

Check that the operator is running:

kubectl get pods -n dorgu-system

Expected output:

NAME                              READY   STATUS    RESTARTS   AGE
dorgu-operator-6d4b5c7f9-x2k4p   1/1     Running   0          30s

Verify the CRDs are installed:

kubectl get crd | grep dorgu

Expected output:

applicationpersonas.dorgu.io   2026-03-23T00:00:00Z
clusterpersonas.dorgu.io       2026-03-23T00:00:00Z

Quickstart

Apply your first persona and see the operator in action

Configuration

Customize flags and Helm values