{
  "schema_version": 2,
  "id": "operate/rs/databases/flash/quickstart",
  "title": "Flex and Auto Tiering quick start",
  "url": "https://redis.io/docs/latest/operate/rs/databases/flash/quickstart/",
  "summary": "Get started with Flex and Auto Tiering quickly, creating a cluster and database using flash storage.",
  "aliases": [
    "/operate/rs/databases/auto-tiering/quickstart/"
  ],
  "tags": [
    "docs",
    "operate",
    "rs"
  ],
  "last_updated": "2026-10-01T15:48:36+01:00",
  "page_type": "content",
  "content_hash": "8537a1261cd79ee58a8d33e4642c577b8aaf9284fc720335b1b95fcbad662efb",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "This article includes a quick start for 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.\n\n\nThis page guides you through a quick setup of [Flex and Auto Tiering](https://redis.io/docs/latest/operate/rs/databases/flash) with a single node for testing and demo purposes.\n\nFor production environments, you can find more detailed installation instructions in the [install and setup](https://redis.io/docs/latest/operate/rs/installing-upgrading) section.\n\nThe steps to set up a Redis Software cluster using Flex\nwith a single node are:\n\n1. Install Redis Software or run it in a Docker\n    container.\n1. Set up a Redis Software cluster with Flex.\n1. Create a new database with Flex enabled.\n1. Connect to your new database."
    },
    {
      "id": "before-deployment",
      "title": "Before deployment",
      "role": "content",
      "text": "Before you set up a flash-enabled cluster and create a Flex or Auto Tiering database, consider the following:\n\n- Avoid a large number of keys or long key names. With Auto Tiering, all key names are stored in RAM regardless of whether their values are on flash. High key count alone can exhaust the RAM limit even when individual key names are short.\n\n- Avoid large collection types (hashes, sets, or lists with millions of elements) whose total serialized size approaches or exceeds the RAM limit. Unlike scalar values, large collections cannot be partially offloaded to flash and must fit in RAM when accessed.\n\n- Databases cannot store keys or values larger than 4GB in flash storage. Keys or values larger than 4GB are stored in RAM only. If oversized keys consume the shard's available RAM, the shard can return out-of-memory errors even when flash storage has free space remaining."
    },
    {
      "id": "install-redis-software",
      "title": "Install Redis Software",
      "role": "setup",
      "text": ""
    },
    {
      "id": "bare-metal-vm-cloud-instance",
      "title": "Bare metal, VM, Cloud instance",
      "role": "content",
      "text": "To install on bare metal, a virtual machine, or an instance:\n\n1. Download the binaries from the [Redis Software download center](https://cloud.redis.io/#/sign-up/software?direct=true).\n\n1. Upload the binaries to a Linux-based operating system.\n\n1. Extract the image:\n\n    [code example]\n\n1. After the `tar` command completes, you can find a new `install.sh` script in the current directory:\n\n    [code example]"
    },
    {
      "id": "dockerbased-installation",
      "title": "Docker-based installation",
      "role": "content",
      "text": "For testing purposes, you can run a Redis Software\nDocker container on Windows, MacOS, and Linux.\n\n[code example]"
    },
    {
      "id": "prepare-and-format-flash-memory",
      "title": "Prepare and format flash memory",
      "role": "content",
      "text": "After you [install Redis Software](#install-redis-enterprise-software), use the `prepare_flash` script to prepare and format flash memory:\n\n[code example]\n\nThis script finds unformatted disks and mounts them as RAID partitions in `/var/opt/redislabs/flash`.\n\nTo verify the disk configuration, run:\n\n[code example]"
    },
    {
      "id": "set-up-a-clusterand-enable-flex",
      "title": "Set up a cluster and enable Flex",
      "role": "content",
      "text": "1. Direct your browser to `https://localhost:8443` on the host machine to\nsee the Redis Software Cluster Manager UI.\n\n    > [!NOTE]\n    > Depending on your browser, you may see a certificate error.\n    > Choose \"continue to the website\" to go to the setup screen.\n    >\n\n1. Select **Create new cluster**.\n\n1. Set up account credentials for a cluster administrator, then select **Next** to proceed to cluster setup.\n\n1. Enter your cluster license key if you have one. Otherwise, the cluster uses the trial version.\n\n1. Provide a cluster FQDN such as `mycluster.local`, then select **Next**.\n\n1. In the **Storage configuration** section, turn on the **Enable flash storage** toggle.\n\n1. Select **Create cluster**.\n\n1. Select **OK** to confirm that you are aware of the replacement of the HTTPS TLS\ncertificate on the node, and proceed through the browser warning."
    },
    {
      "id": "create-a-database",
      "title": "Create a database",
      "role": "content",
      "text": "On the **Databases** screen:\n\n1. Select **Quick database**.\n\n1. Verify **Flash** is selected for **Runs on**.\n\n    ![Create a quick database with Runs on Flash selected.](https://redis.io/docs/latest/images/rs/screenshots/databases/quick-db-flash-7-8-2.png)\n\n1. Enter `12000` for the endpoint **Port** number.\n\n1. _(Optional)_ Select **Full options** to see available alerts.\n\n1. Select **Create**.\n\nYou now have a database with Flex enabled!"
    },
    {
      "id": "connect-to-your-database",
      "title": "Connect to your database",
      "role": "content",
      "text": "After you create the database, you can connect to it and store data. See [Test client connection](https://redis.io/docs/latest/operate/rs/databases/connect/test-client-connectivity) for connection options and examples."
    },
    {
      "id": "next-steps",
      "title": "Next steps",
      "role": "content",
      "text": "To see the true performance and scale of Flex, you must tune your I/O path and set the flash path to the mounted path of SSD or NVMe flash memory as that is what it is designed to run on. For more information, see [Flex and Auto Tiering](https://redis.io/docs/latest/operate/rs/databases/flash)."
    }
  ],
  "examples": [
    {
      "id": "bare-metal-vm-cloud-instance-ex0",
      "language": "sh",
      "code": "tar -vxf <downloaded tar file name>",
      "section_id": "bare-metal-vm-cloud-instance"
    },
    {
      "id": "bare-metal-vm-cloud-instance-ex1",
      "language": "sh",
      "code": "sudo ./install.sh -y",
      "section_id": "bare-metal-vm-cloud-instance"
    },
    {
      "id": "dockerbased-installation-ex0",
      "language": "sh",
      "code": "docker run -d --cap-add sys_resource --name rp -p 8443:8443 -p 12000:12000 redislabs/redis:latest",
      "section_id": "dockerbased-installation"
    },
    {
      "id": "prepare-and-format-flash-memory-ex0",
      "language": "sh",
      "code": "sudo /opt/redislabs/sbin/prepare_flash.sh",
      "section_id": "prepare-and-format-flash-memory"
    },
    {
      "id": "prepare-and-format-flash-memory-ex1",
      "language": "sh",
      "code": "sudo lsblk",
      "section_id": "prepare-and-format-flash-memory"
    }
  ]
}