Skip to main content

Documentation Index

Fetch the complete documentation index at: https://dorguai.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Prerequisites

  • Kubernetes cluster 1.24+
  • kubectl configured for your cluster
  • Helm 3.x (for Helm installation)
Install the operator from the OCI registry:
helm install dorgu-operator oci://ghcr.io/dorgu-ai/dorgu-operator-charts/dorgu-operator \
  --version 0.3.0 \
  --namespace dorgu-system \
  --create-namespace
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.3.0 \
  --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.3.0
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