Set Redis version for Azure Cache for Redis

In this article, you'll learn how to configure the Redis software version to be used with your cache instance. Azure Cache for Redis offers the latest major version of Redis and at least one previous version. It will update these versions regularly as newer Redis software is released. You can choose between the two available versions. Keep in mind that your cache will be upgraded to the next version automatically if the version it's using currently is no longer supported.

Note

At this time, Redis 6 does not support Access Control Lists (ACL) or geo-replication between a Redis 4 cache and Redis 6 cache.

Prerequisites

How to create a cache using the Azure portal

To create a cache, follow these steps:

  1. Sign in to the Azure portal and select Create a resource.

  2. On the New page, select Databases and then select Azure Cache for Redis.

    Select Azure Cache for Redis.

  3. On the Basics page, configure the settings for your new cache.

    Setting Suggested value Description
    Subscription Select your subscription. The subscription under which to create this new Azure Cache for Redis instance.
    Resource group Select a resource group, or select Create new and enter a new resource group name. Name for the resource group in which to create your cache and other resources. By putting all your app resources in one resource group, you can easily manage or delete them together.
    DNS name Enter a globally unique name. The cache name must be a string between 1 and 63 characters that contains only numbers, letters, or hyphens. The name must start and end with a number or letter, and can't contain consecutive hyphens. Your cache instance's host name will be <DNS name>.redis.cache.windows.net.
    Location Select a location. Select a region near other services that will use your cache.
    Cache type Select a cache tier and size. The pricing tier determines the size, performance, and features that are available for the cache. For more information, see Azure Cache for Redis Overview.
  4. On the Advanced page, choose a Redis version to use.

    Redis version.

  5. Select Create.

    It takes a while for the cache to be created. You can monitor progress on the Azure Cache for Redis Overview page. When Status shows as Running, the cache is ready to use.

Create a cache using Azure PowerShell

To create a cache using PowerShell:

    New-AzRedisCache -ResourceGroupName "ResourceGroupName" -Name "CacheName" -Location "West US 2" -Size 250MB -Sku "Standard" -RedisVersion "6"

For more information on how to manage Azure Cache for Redis with Azure PowerShell, see here

Create a cache using Azure CLI

To create a cache using Azure CLI:

az redis create --resource-group resourceGroupName --name cacheName --location westus2 --sku Standard --vm-size c0 --redisVersion="6"

For more information on how to manage Azure Cache for Redis with Azure CLI, see here

How to check the version of a cache

You can check the Redis version of a cache by selecting Properties from the Resource menu of the Azure Cache for Redis.

Screenshot of properties selected in the Resource menu.

FAQ

What features aren't supported with Redis 6?

At this time, Redis 6 doesn't support Access Control Lists (ACL). Geo-replication between a Redis 4 cache and a Redis 6 cache is also not supported.

Can I change the version of my cache after it's created?

You can upgrade your existing Redis 4 caches to Redis 6. Upgrading your cache instance is permanent and you can't downgrade your Redis 6 caches to Redis 4 caches.

For more information, see How to upgrade an existing Redis 4 cache to Redis 6.

Next Steps