---
title: Upgrade InfluxDB 3 Core
description: Learn how to upgrade your InfluxDB 3 Core instance to the latest version.
url: https://docs.influxdata.com/influxdb3/core/admin/upgrade/
estimated_tokens: 757
product: InfluxDB 3 Core
version: core
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/core/admin/upgrade/
date: '2026-01-27T12:16:48-06:00'
lastmod: '2026-01-27T12:16:48-06:00'
---

Upgrade your InfluxDB 3 Core version.

* [Before you upgrade](#before-you-upgrade)
* [Upgrade an InfluxDB 3 instance](#upgrade-an-influxdb-3-instance)

## Before you upgrade

Before upgrading your InfluxDB 3 Core instance, review the [release notes](/influxdb3/core/release-notes/) for compatibility requirements and then plan your upgrade strategy.

#### Upgrading to InfluxDB 3.10 is a one-way migration

The first time you start InfluxDB 3.10, it automatically upgrades the on-disk
catalog format from v2 to v3. After migration, 3.9.x and older
binaries are unable to read the new catalog, and fail to start on the same
cluster data.

Before upgrading, back up `{prefix}/catalogs/` and `{prefix}/_catalog_checkpoint`.
Restoring these objects is the only way to roll back to 3.9.x.

### Verify your current version

Before upgrading, verify the InfluxDB 3 Core version running on each node.

#### CLI ####

```bash
influxdb3 --version
```

```bash
docker exec CONTAINER_NAME influxdb3 --version
```

Replace the following:

* `CONTAINER_NAME`: The name of your InfluxDB 3 Core container

The command returns version information similar to the following:

```
influxdb3 3.10.3
```

### Verify your InfluxDB version

Before and after upgrading, verify the InfluxDB 3 Core version running on your instance.

## Upgrade an InfluxDB 3 instance

#### Install script ####

```bash
curl -O https://www.influxdata.com/d/install_influxdb3.sh \
&& sh install_influxdb3.sh core
```

```bash
# 1. Download the new version
curl -L https://dl.influxdata.com/influxdb/releases/influxdb3-core-3.10.3_linux_amd64.tar.gz \
  -o influxdb3-core.tar.gz

# 2. Extract the archive
tar xvzf influxdb3-core.tar.gz

# 3. Stop the service
sudo systemctl stop influxdb3

# 4. Install the new binary
sudo cp influxdb3 /usr/local/bin/

# 5. Start the service
sudo systemctl start influxdb3
```

```bash
docker stop CONTAINER_NAME
docker pull influxdb:core
docker start CONTAINER_NAME
```

Replace the following:

* `CONTAINER_NAME`: The name of your InfluxDB 3 Core container

```bash
docker compose down
docker compose pull
docker compose up -d
```

```powershell
# Download the latest Windows binary
Invoke-WebRequest `
  -Uri "https://dl.influxdata.com/influxdb/releases/influxdb3-core-3.10.3-windows_amd64.zip" `
  -OutFile "influxdb3-core.zip"

# Extract the binary
Expand-Archive -Path influxdb3-core.zip -DestinationPath . -Force

# Stop the service, replace the binary, and start the service
Stop-Service influxdb3
Copy-Item -Path "influxdb3.exe" -Destination "C:\Program Files\InfluxData\influxdb3\" -Force
Start-Service influxdb3
```

#### Related

* [Back up and restore data](/influxdb3/core/admin/backup-restore/)
* [Install InfluxDB 3 Core](/influxdb3/core/install/)
* [InfluxDB 3 Core configuration options](/influxdb3/core/reference/config-options/)
* [Manage databases](/influxdb3/core/admin/databases/)

[upgrade](/influxdb3/core/tags/upgrade/)[administration](/influxdb3/core/tags/administration/)[catalog](/influxdb3/core/tags/catalog/)