---
title: Upgrade InfluxDB Clustered
description: Use Kubernetes to upgrade your InfluxDB Clustered version.
url: https://docs.influxdata.com/influxdb3/clustered/admin/upgrade/
estimated_tokens: 1201
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/clustered/admin/upgrade/
date: '2026-05-15T15:46:14-06:00'
lastmod: '2026-05-15T15:46:14-06:00'
---

Use Kubernetes to upgrade your InfluxDB Clustered version.
The upgrade is carried out using in-place updates, ensuring minimal downtime.
InfluxDB Clustered versioning is defined in the `AppInstance``CustomResourceDefinition` (CRD) in your[`myinfluxdb.yml`](/influxdb3/clustered/install/set-up-cluster/configure-cluster/).

> [!Important]
> InfluxDB Clustered does not support downgrading.
> If you encounter an issue after upgrading,[contact InfluxData support](mailto:support@influxdata.com).

* [Version format](#version-format)
* [Upgrade your InfluxDB Clustered version](#upgrade-your-influxdb-clustered-version)

## Version format

InfluxDB Clustered uses the `YYYYMMDD-BUILD_NUMBER` version format.
For example, a version created on January 1, 2024 would have a version number
similar to the following:

```
20240101-863513
```

## Upgrade your InfluxDB Clustered version

1. [Identify your current InfluxDB Clustered package version](#identify-your-current-influxdb-clustered-package-version)
2. [Identify the version to upgrade to](#identify-the-version-to-upgrade-to)
3. [Update your image to use a new package version](#update-your-image-to-use-a-new-package-version)
4. [Apply the updated image](#apply-the-updated-image)

### Identify your current InfluxDB Clustered package version

Use the following command to return the image Kubernetes uses to build your
InfluxDB cluster:

```sh
kubectl get appinstances.kubecfg.dev influxdb -n influxdb -o jsonpath='{.spec.package.image}'
```

The package version number is at the end of the returned string (after `influxdb:`):

```sh
us-docker.pkg.dev/influxdb2-artifacts/clustered/influxdb:PACKAGE_VERSION
```

### Identify the version to upgrade to

All available InfluxDB Clustered package versions are provided in the[InfluxDB Clustered release notes](/influxdb3/clustered/reference/release-notes/clustered/).
Find the package version you want to upgrade to and copy the version number.

#### Checkpoint releases

Some InfluxDB Clustered releases are *checkpoint releases* that introduce a
breaking change to an InfluxDB component.
Checkpoint releases are only made when absolutely necessary and are clearly
identified in the [InfluxDB Clustered release notes](/influxdb3/clustered/reference/release-notes/clustered/).

**When upgrading, always upgrade to each checkpoint release first, before proceeding
to newer versions.**

#### Upgrade to checkpoint releases first

Upgrading past a checkpoint release without first upgrading to it may result
in corrupt or lost data.

[](#view-checkpoint-release-upgrade-example)

View checkpoint release upgrade example

Given the following InfluxDB Clustered versions (ordered newest to oldest):

|Available Versions|                      |
|------------------|----------------------|
| 20240215-433509  |                      |
| 20240214-863513  |    **checkpoint**    |
| 20240111-824437  |                      |
| 20231213-791734  |                      |
| 20231117-750011  |                      |
| 20231115-746129  |                      |
| 20231024-711448  |                      |
| 20231004-666907  |    **checkpoint**    |
| 20230922-650371  |*Your current version*|

To upgrade to the most recent version (`20240215-433509`), you **must** do the
following:

1. Upgrade to the `20231004-666907` checkpoint release.
2. Upgrade to the `20240214-863513` checkpoint release.
3. Upgrade to `20240215-433509`.

You can upgrade to versions between checkpoint releases, but you must always
upgrade to a checkpoint before upgrading beyond it.

### Update your image to use a new package version

In your `myinfluxdb.yml`, update the package version defined in`spec.package.image` to the version you want to upgrade to.

```yml
apiVersion: kubecfg.dev/v1alpha1
kind: AppInstance
# ...
spec:
  package:
    # ...
    image: us-docker.pkg.dev/influxdb2-artifacts/clustered/influxdb:PACKAGE_VERSION
```

Replace `PACKAGE_VERSION` with
the version number to upgrade to.

### Apply the updated image

Use the following command to apply the updated image configuration and upgrade
your InfluxDB Cluster:

```sh
kubectl apply \
  --filename myinfluxdb.yml \
  --namespace influxdb
```

#### Related

* [Install InfluxDB Clustered](/influxdb3/clustered/install/)
* [Configure your InfluxDB cluster](/influxdb3/clustered/install/set-up-cluster/configure-cluster/)
* [Deploy your InfluxDB cluster](/influxdb3/clustered/install/set-up-cluster/deploy/)

[upgrade](/influxdb3/clustered/tags/upgrade/)
| Available Versions |  |
| --- | --- |
| Available Versions |  |
| 20240215-433509 |  |
| 20240214-863513 | checkpoint |
| 20240111-824437 |  |
| 20231213-791734 |  |
| 20231117-750011 |  |
| 20231115-746129 |  |
| 20231024-711448 |  |
| 20231004-666907 | checkpoint |
| 20230922-650371 | Your current version |