{
  "schema_version": 2,
  "id": "operate/rs/databases/flash/storage-engine",
  "title": "Manage Auto Tiering storage engine",
  "url": "https://redis.io/docs/latest/operate/rs/databases/flash/storage-engine/",
  "summary": "Manage the storage engine used for your database with auto tiering enabled.",
  "aliases": [
    "/operate/rs/databases/auto-tiering/storage-engine/"
  ],
  "tags": [
    "docs",
    "operate",
    "rs"
  ],
  "last_updated": "2026-09-24T09:16:24+01:00",
  "page_type": "content",
  "content_hash": "9367bf5077e4d6d9c11a87328dce05a6517c5ee25bb106fa365a069f65bafdb1",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "This article includes information about the storage engines used by Flex and its predecessor Auto Tiering. For more detailed information about Flex, see the dedicated [Flex databases](https://redis.io/docs/latest/operate/rs/flex) section instead."
    },
    {
      "id": "manage-the-storage-engine",
      "title": "Manage the storage engine",
      "role": "content",
      "text": "Auto Tiering supports two storage engines:\n\n- Speedb: Redis proprietary storage engine. The default and recommended storage engine as of Redis Software version 7.2.4.\n\n- [RocksDB](https://rocksdb.org/): Used up to Redis version 6.2. Deprecated for later Redis versions.\n\nFlex supports Speedb only.\n\n> [!WARNING]\n> Switching between storage engines requires guidance by Redis Support or your Account Manager."
    },
    {
      "id": "change-the-storage-engine",
      "title": "Change the storage engine",
      "role": "content",
      "text": "1. Change the cluster level configuration for default storage engine.\n\n  * API:\n\n      [code example]\n\n  * CLI:\n\n      [code example]\n\n2. Restart the each database on the cluster one by one.\n\n     [code example]\n\n> [!NOTE]\n>  We recommend restarting your database at times with low usage and avoiding peak hours. For databases without persistence enabled, we also recommend using export to backup your database first."
    },
    {
      "id": "monitor-the-storage-engine",
      "title": "Monitor the storage engine",
      "role": "content",
      "text": "To get the current cluster level default storage engine run:\n\n* Use the `rladmin info cluster` command look for ‘bigstore_driver’.\n\n* Use the REST API:\n\n     [code example]\n\nVersions of Redis Software 7.2 and later provide a metric called `bdb_bigstore_shard_count` to help track the shard count per database, filtered by `bdb_id` and by storage engine as shown below:\n\n\n  [code example]\n\nFor more about metrics for Redis Software’s integration with Prometheus, see [Prometheus integration](https://redis.io/docs/latest/integrate/prometheus-with-redis-enterprise/prometheus-metrics-definitions)."
    }
  ],
  "examples": [
    {
      "id": "change-the-storage-engine-ex0",
      "language": " sh",
      "code": "curl -k -u <username>:<password> -X PUT -H \"Content-Type: application/json\" -d '{\"bigstore_driver\":\"speedb\"}' https://localhost:9443/v1/cluster",
      "section_id": "change-the-storage-engine"
    },
    {
      "id": "change-the-storage-engine-ex1",
      "language": "sh",
      "code": "rladmin cluster config bigstore_driver {speedb | rocksdb}",
      "section_id": "change-the-storage-engine"
    },
    {
      "id": "change-the-storage-engine-ex2",
      "language": "sh",
      "code": "rladmin restart db { db:<id> | <name> }",
      "section_id": "change-the-storage-engine"
    },
    {
      "id": "monitor-the-storage-engine-ex0",
      "language": "sh",
      "code": "curl -k -u <username>:<password> -X GET -H \"Content-Type: application/json\" https://localhost:9443/v1/cluster",
      "section_id": "monitor-the-storage-engine"
    },
    {
      "id": "monitor-the-storage-engine-ex1",
      "language": "sh",
      "code": "bdb_bigstore_shard_count{bdb=\"1\",cluster=\"mycluster.local\",driver=\"rocksdb\"} 1.0\n  bdb_bigstore_shard_count{bdb=\"1\",cluster=\"mycluster.local\",driver=\"speedb\"} 2.0",
      "section_id": "monitor-the-storage-engine"
    }
  ]
}
