---
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: 6642
product: InfluxDB 3 Enterprise
version: enterprise
---

# Deploy InfluxDB 3 Enterprise on Kubernetes

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:
    
    ```bash
    helm repo add influxdata https://helm.influxdata.com/
    ```
    
2. Update your Helm repositories:
    
    ```bash
    helm repo update
    ```
    
3. Create a namespace for InfluxDB:
    
    ```bash
    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:
    
    ```bash
    helm install influxdb3-enterprise influxdata/influxdb3-enterprise \
      --namespace influxdb \
      --values values.yaml
    ```
    
6. Verify the deployment:
    
    ```bash
    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.

<!-- Tabbed content: Select one of the following options -->

**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

**Azure Blob Storage:**

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

**Google Cloud Storage:**

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
```

**S3-compatible (MinIO):**

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

<!-- End tabbed content -->

### 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
```

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/)