Skip to content

Installation

Work in Progress

The operator is under active development. CRDs and APIs may change.

Prerequisites

  • Kubernetes or OpenShift cluster
  • Helm 3.x

Install via Helm (OCI)

The Helm chart is published as an OCI artifact to GitHub Container Registry.

helm install openvox-operator \
  oci://ghcr.io/slauger/charts/openvox-operator \
  --namespace openvox-system \
  --create-namespace

Verify

kubectl get pods -n openvox-system

You should see the operator pod running:

NAME                                READY   STATUS    AGE
openvox-operator-7b8f9d6c4-x2k9m   1/1     Running   30s

Namespace-Scoped Mode

By default the operator watches all namespaces (cluster-scoped). To restrict it to a single namespace:

helm install openvox-operator \
  oci://ghcr.io/slauger/charts/openvox-operator \
  --namespace openvox-system \
  --create-namespace \
  --set scope.mode=namespace \
  --set scope.watchNamespace=my-namespace

In namespace mode the operator uses Role/RoleBinding instead of ClusterRole/ClusterRoleBinding and only reconciles resources in the configured namespace.

Next Steps

Once the operator is running, follow the Quick Start guide to deploy an OpenVox stack.