---
title: Upgrading to InfluxDB 1.6.x

menu:
    influxdb_1_6:
        name: Upgrading
        weight: 25
        parent: Administration
---

-   [Upgrading InfluxDB 1.3 / 1.4 (no TSI Preview) to 1.6.x (TSI enabled)](#upgrading-influxdb-1-3-1-4-no-tsi-preview-to-1-6-x-tsi-enabled)
-   [Upgrading InfluxDB 1.3 - 1.4 (TSI Preview enabled) to 1.6.x (TSI enabled)](#upgrading-influxdb-1-3-1-4-tsi-preview-enabled-to-1-6-x-tsi-enabled)
-   [Upgrading InfluxDB 1.0 - 1.4 to 1.6.x](#upgrading-influxdb-1-0-1-4-to-1-6-x)
-   [Upgrading InfluxDB Enterprise clusters](#upgrading-influxdb-enterprise-clusters)

## Upgrading InfluxDB 1.3 / 1.4 (no TSI Preview) to 1.6.x (TSI enabled)

Starting with the InfluxDB 1.6 release, enabling Time Series Index (TSI) is recommended for all customers. To learn more about TSI, see:

-   [Time Series Index (TSI) overview](/influxdb/v1.6/concepts/time-series-index/)
-   [Time Series Index (TSI) details](/influxdb/v1.6/concepts/tsi-details/)

The upgrade steps below guide you in upgrading InfluxDB OSS and InfluxDB Enterprise, enabling TSI functionality.

> **_Note:_** For the InfluxDB 1.6 release, the default continues to use TSM-based shards as in earlier versions, with in-memory indexes.

**To upgrade from 1.4 (no TSI Preview) to 1.6.x (TSI enabled):**

Follow these steps to upgrade an earlier InfluxDB instance (versions 1.0 to 1.4) that did not enable the TSI Preview to an InfluxDB 1.6 instance with Time Series Index (TSI) enabled.

1. [Download](https://portal.influxdata.com/downloads) InfluxDB version 1.6.x and install the upgrade.

2. Update your InfluxDB configuration.

-   If using the InfluxDB configuration file, migrate your InfluxDB configuration file customizations to the InfluxDB 1.6 [configuration file](/influxdb/v1.6/administration/config/).
-   Add, or modify, your environment variables.

*   Migrate configuration file customizations in your InfluxDB 1.4 configuration file to the InfluxDB 1.6.x [configuration file](/influxdb/v1.6/administration/config/)
*   Add environment variables, if desired.

3. Enable the Time Series Index (TSI).

-   If using the InfluxDB configuration file, find the `[data]` section, uncomment `index-version = "inmem"' and change the value to`tsi1`.

    -   Example: `index-version = "tsi1"'

-   If using environment variables, set `INFLUXDB_DATA_INDEX_VERSION` to `tsi1`.
    -   Example: `export INFLUXDB_DATA_INDEX_VERSION="tsi1"`

4. Convert existing TSM-based shards to TSI-supported shards.

-   Use [influx_inspect buildtsi](/influxdb/v1.6/tools/influx_inspect/#influx-inspect/#buildtsi) for converting your TSM-based shards to TSI-based shards.

5. Restart the `influxdb` service.

## Upgrading InfluxDB 1.3 - 1.4 (TSI Preview enabled) to 1.6.x (TSI enabled)

Follow these steps to upgrade an earlier InfluxDB instance (versions 1.3 and 1.4) that had the TSI Preview enabled to an InfluxDB 1.6 instance with Time Series Index (TSI) enabled.

1. [Download](https://portal.influxdata.com/downloads) InfluxDB version
   1.6 and install the upgrade.

2. Update your InfluxDB configuration.

-   If using the InfluxDB configuration file, migrate your InfluxDB configuration file customizations to the InfluxDB 1.6 [configuration file](/influxdb/v1.6/administration/config/).
-   Add, or modify, your environment variables.

3. Enable the Time Series Index (TSI).

-   If using the InfluxDB configuration file, find the `[data]` section, uncomment `index-version = "inmem"`, and change the value to `tsi1`.

    -   Example: `index-version = "tsi1"`

-   If using an environment variable, set `INFLUXDB_DATA_INDEX_VERSION` to `tsi1`.
    -   Example: `export INFLUXDB_DATA_INDEX_VERSION=tsi1`

4. Delete all existing TSM-based shard `index` directories.

-   Removing the existing index directories ensures there are no incompatible index files.
-   By default, the index directories are located at `/<shard_ID>/index`.
    -   Example: `/2/index`

5. Convert existing shards to support TSI.

-   When Time Series Index (TSI) is enabled, new shards use the TSI index. Existing shards must be converted to support TSI.
-   Run the [influx_inspect buildtsi](/influxdb/v1.6/tools/influx_inspect/#buildtsi) command to convert existing TSM-based shards to TSI-based shards.

5. Restart the `influxdb` service.

## Upgrading InfluxDB 1.0 - 1.4 to 1.6.x

Follow these steps to upgrade an earlier InfluxDB instance (versions 1.0 to 1.4) using the default TSM in-memory indexing to an InfluxDB 1.6 instance.

1. [Download](https://portal.influxdata.com/downloads) InfluxDB 1.6.

2. [Install](/influxdb/v1.6/introduction/installation) InfluxDB 1.6.

3. Update your InfluxDB configuration.

-   If using the InfluxDB configuration file, migrate your InfluxDB configuration file customizations to the InfluxDB 1.6 [configuration file](/influxdb/v1.6/administration/config/).
-   Add, or modify, your environment variables.

5. Restart the `influxdb` service.

## Switching between TSM and TSI indexes

After installing and upgrading to InfluxDB 1.6, you can switch between using the TSM index and the TSI index if needed.

### Switching from TSM index to TSI index:

1. Enable TSI.
2. Convert TSM-based shards to TSI-based shards.
3. Restart the `influxdb` service.

### Switching from disk TSI index to TSM index:

1. Enable `inmem`.
2. Delete all shard `index` directories.
3. Restart the `influxdb` service.

## Upgrading InfluxDB Enterprise clusters

See [Upgrading InfluxDB Enterprise clusters](/enterprise_influxdb/v1.6/administration/upgrading/).