---
title: Deploy InfluxDB 3 Enterprise on Kubernetes
description: Use the official Helm chart to deploy InfluxDB 3 Enterprise on Kubernetes for predictable, repeatable deployments aligned with production best practices.
url: https://docs.influxdata.com/influxdb3/enterprise/install/kubernetes/
estimated_tokens: 2014
product: InfluxDB 3 Enterprise
version: enterprise
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/enterprise/install/kubernetes/
date: '2025-12-22T17:52:31-05:00'
lastmod: '2025-12-22T17:52:31-05:00'
---

Use the official InfluxDB 3 Enterprise Helm chart to deploy InfluxDB 3 Enterprise
on Kubernetes.
The Helm chart packages recommended deployment patterns into a single chart,
eliminating the need to maintain custom manifests or configure deployments from scratch.

#### Beta status

The InfluxDB 3 Enterprise Helm chart is currently in **beta**.
During this phase, InfluxData is refining defaults and ensuring upgrades
behave as operators expect.[Find support for InfluxDB 3 Enterprise](#find-support) or[report a Helm chart issue](#report-an-issue-with-helm-charts).

* [Key features](#key-features)
* [Prerequisites](#prerequisites)
* [Install the Helm chart](#install-the-helm-chart)
* [Configuration options](#configuration-options)
  * [Object storage](#object-storage)
  * [Cluster configuration](#cluster-configuration)
  * [Ingress](#ingress)

* [Upgrade the deployment](#upgrade-the-deployment)
* [Uninstall](#uninstall)
* [Troubleshooting](#troubleshooting)
* [Report an issue with Helm charts](#report-an-issue-with-helm-charts)
* [Find support](#find-support)

## Key features

* **Simplified deployment**: Deploy InfluxDB 3 Enterprise with a single Helm chart
  instead of maintaining custom Kubernetes manifests
* **Production patterns**: Includes recommended configurations for
  object storage, cluster settings, and environment-specific overrides
* **Standard Helm workflows**: Use familiar Helm mechanisms for installs,
  upgrades, and rollouts
* **Environment overrides**: Customize deployments for different environments
  (development, staging, production)

## Prerequisites

Before deploying InfluxDB 3 Enterprise on Kubernetes, ensure you have:

* A Kubernetes cluster (version 1.25 or later)
* [Helm](https://helm.sh/docs/intro/install/) installed (version 3.0 or later)
* [`kubectl`](https://kubernetes.io/docs/tasks/tools/) configured to access your cluster
* Object storage configured (Amazon S3, Azure Blob Storage, Google Cloud Storage,
  or S3-compatible storage such as MinIO)

### Licensing

InfluxDB 3 Enterprise requires a license to run.
For more information about license types, activation, and management, see[Manage your InfluxDB 3 Enterprise license](/influxdb3/enterprise/admin/license/).

## Install the Helm chart

1. Add the InfluxData Helm repository:

   ```
   helm repo add influxdata https://helm.influxdata.com/
   ```

2. Update your Helm repositories:

   ```
   helm repo update
   ```

3. Create a namespace for InfluxDB:

   ```
   kubectl create namespace influxdb
   ```

4. Create a `values.yaml` file with your configuration.
   See [Configuration options](#configuration-options) for available settings.

5. Install the chart:

   ```
   helm install influxdb3-enterprise influxdata/influxdb3-enterprise \
     --namespace influxdb \
     --values values.yaml
   ```

6. Verify the deployment:

   ```
   kubectl get pods --namespace influxdb
   ```

## Configuration options

The Helm chart supports common production configurations through the `values.yaml` file.
Download the default values file as a starting point:

```bash
curl -O https://raw.githubusercontent.com/influxdata/helm-charts/master/charts/influxdb3-enterprise/values.yaml
```

### Object storage

Configure object storage for Parquet file storage.
InfluxDB 3 Enterprise supports Amazon S3, Azure Blob Storage, Google Cloud Storage,
and S3-compatible storage.

#### Amazon S3 ####

Configure Amazon S3 as your object store:

```yaml
objectStore:
  type: s3
  bucket: S3_BUCKET
  region: S3_REGION
  accessKey: S3_ACCESS_KEY
  secretKey: S3_SECRET_KEY
```

Replace the following:

* `S3_BUCKET`: your S3 bucket name
* `S3_REGION`: AWS region (for example, `us-east-1`)
* `S3_ACCESS_KEY`: AWS access key ID
* `S3_SECRET_KEY`: AWS secret access key

Configure Azure Blob Storage as your object store:

```yaml
objectStore:
  type: azure
  bucket: AZURE_CONTAINER
  account: AZURE_ACCOUNT
  accessKey: AZURE_ACCESS_KEY
```

Replace the following:

* `AZURE_CONTAINER`: your Azure container name
* `AZURE_ACCOUNT`: Azure storage account name
* `AZURE_ACCESS_KEY`: Azure storage access key

Configure Google Cloud Storage as your object store:

```yaml
objectStore:
  type: gcs
  bucket: GCS_BUCKET
  serviceAccountSecret:
    name: gcs-credentials
    key: credentials.json
```

Replace `GCS_BUCKET`with your Google Cloud Storage bucket name.

Create a Kubernetes secret with your service account credentials:

```bash
kubectl create secret generic gcs-credentials \
  --from-file=credentials.json=/path/to/service-account.json \
  --namespace influxdb
```

Configure S3-compatible storage (such as MinIO) as your object store:

```yaml
objectStore:
  type: s3
  bucket: MINIO_BUCKET
  endpoint: MINIO_ENDPOINT
  accessKey: MINIO_ACCESS_KEY
  secretKey: MINIO_SECRET_KEY
  forcePathStyle: true
```

Replace the following:

* `MINIO_BUCKET`: your MinIO bucket name
* `MINIO_ENDPOINT`: MinIO endpoint URL (for example, `http://minio.minio.svc:9000`)
* `MINIO_ACCESS_KEY`: MinIO access key
* `MINIO_SECRET_KEY`: MinIO secret key

### Cluster configuration

Configure cluster-level settings:

```yaml
# Cluster name
clusterName: my-influxdb-cluster

# Resource limits and requests
resources:
  limits:
    cpu: "4"
    memory: 8Gi
  requests:
    cpu: "2"
    memory: 4Gi

# Persistent storage for Write-Ahead Log (WAL)
persistence:
  enabled: true
  size: 10Gi
  storageClass: standard
```

### Ingress

Configure ingress to expose the InfluxDB API:

```yaml
ingress:
  enabled: true
  hosts:
    - INFLUXDB_HOST
  tls:
    - secretName: influxdb-tls
      hosts:
        - INFLUXDB_HOST
```

Replace `INFLUXDB_HOST`with your InfluxDB hostname (for example, `influxdb.example.com`).

## Upgrade the deployment

To upgrade your deployment after modifying `values.yaml`:

```bash
helm upgrade influxdb3-enterprise influxdata/influxdb3-enterprise \
  --namespace influxdb \
  --values values.yaml
```

To upgrade to a new chart version:

```bash
helm repo update
helm upgrade influxdb3-enterprise influxdata/influxdb3-enterprise \
  --namespace influxdb \
  --values values.yaml
```

## Uninstall

To remove the InfluxDB deployment:

```bash
helm uninstall influxdb3-enterprise --namespace influxdb
```

> [!Warning]
> Uninstalling the Helm release does not delete persistent volumes or
> data in object storage.
> To remove *all* data, manually delete the persistent volume claims
> and object storage bucket.

## Troubleshooting

### View pod logs

To view logs from the InfluxDB pod:

```bash
kubectl logs -l app.kubernetes.io/name=influxdb3-enterprise \
  --namespace influxdb
```

### Check pod status

To check the status of InfluxDB pods:

```bash
kubectl get pods --namespace influxdb -o wide
```

### Describe pod for events

To see detailed information and events for a pod:

```bash
kubectl describe pod POD_NAME --namespace influxdb
```

Replace `POD_NAME`with the name of the pod (from `kubectl get pods`).

## Report an issue with Helm charts

For Helm chart issues or feedback, see the Helm charts repository [issues page](https://github.com/influxdata/helm-charts/issues).

## Find support

The [InfluxDB Discord server](https://discord.gg/9zaNCW2PRT) is the best place to find community support for InfluxDB 3 Enterprise.
Customers with a [commercial license](/influxdb3/enterprise/admin/license/) can contact [InfluxData Support](https://support.influxdata.com).

[Install InfluxDB 3 Enterprise](/influxdb3/enterprise/install/)[Get started with InfluxDB 3 Enterprise](/influxdb3/enterprise/get-started/)

#### Related

* [Get started with InfluxDB 3 Enterprise](/influxdb3/enterprise/get-started/)
* [Configure object storage](/influxdb3/enterprise/admin/object-storage/)
* [Create a multi-node cluster](/influxdb3/enterprise/get-started/multi-server/)
* [InfluxDB 3 Enterprise Helm Chart (GitHub)](https://github.com/influxdata/helm-charts/tree/master/charts/influxdb3-enterprise)

[install](/influxdb3/enterprise/tags/install/)[kubernetes](/influxdb3/enterprise/tags/kubernetes/)[helm](/influxdb3/enterprise/tags/helm/)