Configure your InfluxDB cluster

Install InfluxDB Clustered
Phase 1: Set up your cluster

InfluxDB Clustered deployments are managed using Kubernetes and configured using a YAML configuration file. Apply configuration settings to your cluster by editing and applying a Kubernetes custom resource (CRD) called AppInstance. The AppInstance CRD is defined in a YAML file (use the example-customer.yml provided by InfluxData as a template).

We recommend editing the AppInstance resource directly as the primary method for configuring and managing your InfluxDB cluster. After you have edited your AppInstance, use the kubit CLI or kubectl deployment tool, depending on your requirements.

If you are required to use Helm, there is an InfluxDB Clustered Helm chart available that acts as a wrapper for the AppInstance resource and lets you use Helm to manage configuration changes in your InfluxDB cluster.

Choose the right deployment tool for your environment

Deployment Tool	Best For	Requirements	Considerations
kubectl	Standard deployments	Cluster-wide permissions	Simplest option if you have required permissions
kubit CLI	Limited permission environments or air-gapped	Local workstation access	Better for environments with permission restrictions
Helm	Teams standardized on Helm	Helm installation (includes kubit operator)	Provides consistent deployment with other Helm-managed applications

Configure your InfluxDB AppInstance resource directly

Configure your InfluxDB cluster by editing configuration options in the provided AppInstance resource.

Configure AppInstance directly Recommended