New to KubeDB? Please start here.

Running HanaDB

This tutorial shows how to run a SAP HANA database with KubeDB.

Note: YAML files used in this tutorial are stored in docs/examples/hanadb/quickstart.

Before You Begin

  • Prepare a Kubernetes cluster and kubectl.
  • Install KubeDB from /docs/setup/README.md.
  • This tutorial uses docs/examples/hanadb/quickstart/system-replication.yaml as the working example manifest.
  • Create namespace:
kubectl create ns demo

Check Available StorageClass

kubectl get storageclass

The example manifests use storageClassName: local-path and request 64Gi storage for each HanaDB pod. Update the storage class if your cluster uses a different provisioner.

Check Available HanaDBVersion

kubectl get hanadbversions

Create a HanaDB Cluster

apiVersion: kubedb.com/v1alpha2
kind: HanaDB
metadata:
  name: hanadb-cluster
  namespace: demo
spec:
  version: "2.0.82"
  replicas: 3
  storageType: "Durable"
  topology:
    mode: SystemReplication
    systemReplication:
      replicationMode: fullsync
      operationMode: logreplay_readaccess
  storage:
    accessModes: ["ReadWriteOnce"]
    resources:
      requests:
        storage: 64Gi
    storageClassName: local-path
kubectl apply -f https://github.com/kubedb/docs/raw/v2026.4.27/docs/examples/hanadb/quickstart/system-replication.yaml
kubectl get hanadb -n demo hanadb-cluster -w

Verify the Cluster

kubectl get hanadb -n demo
kubectl describe hanadb -n demo hanadb-cluster

When status.phase becomes Ready, the HanaDB deployment is ready for application traffic.

Cleaning up

kubectl delete hanadb -n demo hanadb-cluster
kubectl delete ns demo