# QuestDB Enterprise Kubernetes Operator

Deploy and operate QuestDB Enterprise clusters on Kubernetes.

# QuestDB Enterprise Kubernetes Operator

<EnterpriseNote>
  The Kubernetes Operator manages QuestDB Enterprise clusters. For open source
  QuestDB on Kubernetes, use the [QuestDB Helm
  chart](/docs/deployment/kubernetes/).
</EnterpriseNote>

:::warning[Supported platforms] The API is `questdb.io/v1alpha1` and may change between
releases. Amazon EKS and Azure AKS are supported on the tested versions in the [support matrix](/docs/enterprise-kubernetes-operator/known-limitations/#supported-platforms-and-versions).
See [Support](/docs/enterprise-kubernetes-operator/support/) for support expectations.
:::

The QuestDB Enterprise Operator manages the Kubernetes lifecycle of QuestDB
Enterprise: database pods and storage, configuration, engine-driven backup,
replication and promotion, restore and point-in-time recovery, and health
status.

You bring an existing object store. The operator has no cloud IAM or identity
and performs no object-store I/O: it never creates, reads, or deletes buckets or
containers. With static authentication, it reads the referenced Kubernetes
Secret only to inject database pod configuration; ambient EKS IRSA avoids that
static Secret. QuestDB database pods perform all object-store I/O.

## Choose your path

- **Amazon EKS:** follow the
  [EKS onboarding guide](/docs/enterprise-kubernetes-operator/getting-started/aws/).
- **Azure AKS:** follow the
  [AKS onboarding guide](/docs/enterprise-kubernetes-operator/getting-started/azure/).
- **Shared install requirements:** see
  [Installation](/docs/enterprise-kubernetes-operator/installation/).
- **Restore or migrate existing data:** follow the cloud-neutral
  [restore and migration guide](/docs/enterprise-kubernetes-operator/getting-started/restore-and-migrate/).
- **PGWire TLS and network isolation:** plan them before creation with
  [Configuration](/docs/enterprise-kubernetes-operator/configuration/#pgwire-tls).
- **Operate the operator:** use the
  [operator runbook](/docs/enterprise-kubernetes-operator/operations/operator/).
- **Operate a database:** use the
  [database](/docs/enterprise-kubernetes-operator/operations/database/),
  [backup and restore](/docs/enterprise-kubernetes-operator/operations/backup-restore/),
  or
  [high-availability](/docs/enterprise-kubernetes-operator/high-availability/)
  runbook.
- **Diagnose a problem:** use
  [Troubleshooting](/docs/enterprise-kubernetes-operator/troubleshooting/).

Use [Configuration](/docs/enterprise-kubernetes-operator/configuration/) for
common resource shapes and the
[API Reference](/docs/enterprise-kubernetes-operator/reference/api/) for every
field, default, and validation rule.