---
title: "Migrate to TSDB | Grafana Enterprise Logs documentation"
description: "Migration guide for moving from any of the older indexes to TSDB"
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# Migrate to TSDB

[TSDB](../../../operations/storage/tsdb/) is the recommended index type for Loki and is where the current development lies. If you are running Loki with [boltb-shipper](../../../operations/storage/boltdb-shipper/) or any of the [legacy index types](/docs/loki/latest/configure/storage/#index-storage) that have been deprecated, we strongly recommend migrating to TSDB.

### Configure TSDB index for an upcoming period

To begin the migration, add a new [period\_config](/docs/loki/latest/configure/#period_config) entry in your [schema\_config](/docs/loki/latest/configure/#schema_config). You can read more about schema config [here](/docs/loki/latest/configure/storage/#schema-config).

> Note
> 
> You must roll out the new `period_config` change to all Loki components in order for it to take effect.

This example adds a new `period_config` which configures Loki to start using the TSDB index for the data ingested starting from `2023-10-20`.

![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```none
schema_config:
  configs:
    - from: 2023-01-01
      store: boltdb-shipper
      object_store: filesystem
      schema: v11
      index:
        prefix: index_
        period: 24h
    - from: 2023-10-20 ①
      store: tsdb ②
      object_store: filesystem ③
      schema: v13 ④
      index:
        prefix: index_
        period: 24h
```

1. You must set the new period `from` to a date in the future.
2. Update the new period to use TSDB as the index type by setting `store: tsdb`.
3. This sample configuration uses filesystem as the storage in both the periods. If you want to use a different storage for the TSDB index and chunks, you can specify a different `object_store` in the new period.
4. Update the schema to v13 which is the recommended version at the time of writing. Please refer to the [configure page](/docs/loki/latest/configure/#period_config) for the current recommended version.

### Configure TSDB shipper

It’s also important that you configure the `tsdb_shipper` block in [storage\_config](/docs/loki/latest/configure/#storage_config). Specifically the following options:

- `active_index_directory`: directory where ingesters would write index files which will then be uploaded by shipper to configured storage.
- `cache_location`: cache location for downloading index files from the storage for use in query path.

![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```none
storage_config:
  tsdb_shipper:
    active_index_directory: /data/tsdb-index
    cache_location: /data/tsdb-cache
```

### Run compactor

We strongly recommended running the [compactor](../../../operations/storage/retention/#compactor) when using TSDB index. It is responsible for running compaction and retention on TSDB index. Not running index compaction will result in sub-optimal query performance.

Please refer to the [compactor section](../../../operations/storage/retention/#compactor) for more information and configuration examples.