Using Helm 3

KubeDB can be installed via Helm using the chart from AppsCode Charts Repository. To install, follow the steps below:

$ helm install kubedb oci://ghcr.io/appscode-charts/kubedb \
  --version v2026.4.27 \
  --namespace kubedb --create-namespace \
  --set-file global.license=/path/to/the/license.txt \
  --wait --burst-limit=10000 --debug
If you are using private Docker registries using self-signed certificates, please pass the registry domains to the operator like below:
$ helm install kubedb oci://ghcr.io/appscode-charts/kubedb \
  --version v2026.4.27 \
  --namespace kubedb --create-namespace \
  --set global.insecureRegistries[0]=hub.example.com \
  --set global.insecureRegistries[1]=hub2.example.com \
  --set-file global.license=/path/to/the/license.txt \
  --wait --burst-limit=10000 --debug

(Alternative) Use License Proxyserver instead of a license file

Instead of passing a license file to every operator, you can install the license-proxyserver chart once. It distributes license tokens to KubeDB and other AppsCode operators inside the cluster, so the helm install kubedb command no longer needs --set-file global.license.

Generate an online license-proxyserver token by following the License Proxyserver guide, then install the chart with that token:

$ helm install license-proxyserver oci://ghcr.io/appscode-charts/license-proxyserver \
  --version v2026.2.16 \
  --namespace kubeops --create-namespace \
  --set platform.baseURL=https://appscode.com \
  --set platform.token=<your-token> \
  --wait --burst-limit=10000 --debug

With the proxyserver running, install KubeDB without the license flag:

$ helm install kubedb oci://ghcr.io/appscode-charts/kubedb \
  --version v2026.4.27 \
  --namespace kubedb --create-namespace \
  --wait --burst-limit=10000 --debug

To see the detailed configuration options, visit here.

Next: enable database engines and verify the installation.