---
title: Upgrade from InfluxDB 2.x to  2.9
description: To upgrade from InfluxDB 2.0 beta 16 or earlier to 2.9, manually upgrade all resources and data to the latest version by completing these steps.
url: https://docs.influxdata.com/influxdb/v2/install/upgrade/v2-to-v2/
estimated_tokens: 463
product: InfluxDB OSS v2
version: v2
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb/v2/install/upgrade/v2-to-v2/
date: '2026-01-30T15:03:13-06:00'
lastmod: '2026-01-30T15:03:13-06:00'
---

This page documents an earlier version of InfluxDB OSS.[InfluxDB 3 Core](/influxdb3/core/) is the latest stable version.

#### API token hashing is enabled by default in InfluxDB OSS 2.9.0

Stronger token security: tokens are stored as hashes on disk, so a
copy of the database file doesn’t expose usable tokens. Existing
tokens are hashed on first startup and the original strings can’t
be recovered afterward — **capture any plaintext tokens you still
need before you upgrade**.

For more information, see [Token hashing](/influxdb/v2/admin/tokens/#token-hashing).

Upgrade to InfluxDB 2.9 from an earlier version of InfluxDB 2.x.

#### InfluxDB 2.0 beta-16 or earlier

If you’re upgrading from InfluxDB 2.0 beta-16 or earlier, you must first[upgrade to InfluxDB 2.0](/influxdb/v2/install/upgrade/v2-beta-to-v2/),
and then complete the steps below.

#### macOS ####

Do one of the following:

* [Use homebrew to upgrade](#use-homebrew-to-upgrade)
* [Manually upgrade](#manually-upgrade)

### Use homebrew to upgrade

```sh
brew upgrade influxdb
```

### Manually upgrade

To manually upgrade, [download and install the latest version of InfluxDB 2.9 for macOS](/influxdb/v2/install/?t=macos/#manually-download-and-install-for-macos)in place of your current 2.x version.

[Download and install the latest version of InfluxDB 2.9 for Linux](/influxdb/v2/install/?t=Linux#download-and-install-influxdb-v2)in place of your current 2.x version.

[Download and install the latest version of InfluxDB 2.9 for Windows](/influxdb/v2/install/?t=Windows)in place of your current 2.x version.

To upgrade to InfluxDB 2.9 with Docker, update your Docker
image to use the latest InfluxDB image.

```sh
influxdb:2.9.1
```

#### Related

* [influxd downgrade](/influxdb/v2/reference/cli/influxd/downgrade/)
* [Install InfluxDB OSS v2](/influxdb/v2/install/)