{
  "id": "active-active",
  "title": "Active-Active databases",
  "url": "https://redis.io/docs/latest/operate/kubernetes/8.0/active-active/",
  "summary": "Create and manage Active-Active Redis Enterprise databases across multiple Kubernetes clusters.",
  "content": "\nRedis Enterprise [Active-Active](https://redis.io/docs/latest/operate/rs/databases/active-active/) databases on Kubernetes provide read and write access to the same dataset from different Kubernetes clusters. This enables globally distributed applications with local read and write access, automatic conflict resolution, and seamless failover capabilities.\n\nActive-Active databases use multi-master replication to keep data synchronized across participating clusters, allowing applications to read and write data locally while maintaining global consistency.\n\n## Active-Active setup methods\n\nThere are two methods for creating an Active-Active database with Redis Enterprise for Kubernetes:\n\n- The `RedisEnterpriseActiveActiveDatabase` (REAADB) custom resource is available for versions 6.4.2 and later.\n- The `crdb-cli` method is available for versions 6.4.2 or earlier.\n\n\nWe recommend creating new Active-Active databases using the RedisEnterpriseActiveActiveDatabase (REAADB) custom resource. This allows you to manage your Active-Active database with the operator and ensures you have the latest features and functionality.\n\n### Active-Active controller method\n\nVersions 6.4.2-6 or later fully support the Active-Active controller. Some of these features were available as a preview in 6.4.2-4 and 6.4.2-5. Please upgrade to 6.4.2-6 for the full set of general availability features and bug fixes.\n\nThis setup method includes the following steps:\n\n1. Gather REC credentials and [prepare participating clusters](https://redis.io/docs/latest/operate/kubernetes/active-active/prepare-clusters).\n2. Create [`RedisEnterpriseRemoteCluster` (RERC)](https://redis.io/docs/latest/operate/kubernetes/active-active/create-reaadb#create-rerc) resources.\n3. Create [`RedisEnterpriseActiveActiveDatabase` (REAADB)](https://redis.io/docs/latest/operate/kubernetes/active-active/create-reaadb#create-reaadb) resource.\n\n### `crdb-cli` method\n\nFor versions 6.4.2 or earlier, this Active-Active setup method includes the following steps:\n\n1. Install and configure an ingress.\n2. Gather configuration details.\n3. Add the `ActiveActive` field to the REC spec.\n4. Create the database with the `crdb-cli` tool.\n\n## Redis Enterprise Active-Active controller for Kubernetes\n\nThese features are supported for general availability in releases 6.4.2-6 and later.\n\n[Active-Active](https://redis.io/docs/latest/operate/rs/databases/active-active/) databases give you read-and-write access to Redis Enterprise clusters (REC) in different Kubernetes clusters or namespaces. Active-Active deployments managed by the Redis Enterprise operator require two additional custom resources: Redis Enterprise Active-Active database (REAADB) and Redis Enterprise remote cluster (RERC).\n\nTo create an Active-Active Redis Enterprise deployment for Kubernetes with these new features, first [prepare participating clusters](https://redis.io/docs/latest/operate/kubernetes/active-active/prepare-clusters) then [create an Active-Active database](https://redis.io/docs/latest/operate/kubernetes/active-active/create-reaadb).\n\n### REAADB custom resource\n\nRedis Enterprise Active-Active database (REAADB) contains a link to the RERC for each participating cluster, and provides configuration and status to the management plane.\n\nFor a full list of fields and options, see the [REAADB API reference](https://redis.io/docs/latest/operate/kubernetes/reference/api/redis_enterprise_active_active_database_api).\n\nFor examples, see the [YAML examples](https://redis.io/docs/latest/operate/kubernetes/reference/yaml/active-active) section.\n\n### RERC custom resource\n\nRedis Enterprise remote cluster (RERC) custom resource contains configuration details for all the participating clusters.\n\nFor a full list of fields and options, see the [RERC API reference](https://redis.io/docs/latest/operate/kubernetes/reference/api/redis_enterprise_remote_cluster_api).\n\nFor examples, see the [YAML examples](https://redis.io/docs/latest/operate/kubernetes/reference/yaml/active-active) section.\n\n### Limitations\n\n* Existing Redis databases cannot be migrated to a REAADB. (DOC-3594)\n* Admission is not blocking REAADB with `shardCount` which exceeds license quota. (RED-96301)\n    Workaround: Fix the problems with the REAADB and reapply.\n* The `\u003crec-name\u003e/\u003crec-namespace\u003e` value must be unique for each RERC resource. (RED-96302)\n* Only global database options are supported, no support for specifying configuration per location.\n* No support for migration from old (`crdb-cli`) Active-Active database method to new Active-Active controller.\n* No support for REAADB with participating clusters co-located within the same Kubernetes cluster, except for a single designated local participating cluster.\n* Active-Active databases cannot be configured as [Redis Flex](https://redis.io/docs/latest/operate/kubernetes/flex) deployments.\n\n## More info\n\nFor more general information about Active-Active, see the [Redis Enterprise Software docs](https://redis.io/docs/latest/operate/rs/databases/active-active/).\n",
  "tags": ["docs","operate","kubernetes"],
  "last_updated": "2026-06-04T14:49:57+01:00",
  "children": [{"id":"prepare-clusters","summary":"Prepare your participating RECs to be part of an Active-Active database deployment.","title":"Prepare participating clusters","url":"https://redis.io/docs/latest/operate/kubernetes/8.0/active-active/prepare-clusters/"},{"id":"create-reaadb","summary":"","title":"Create Active-Active database (REAADB)","url":"https://redis.io/docs/latest/operate/kubernetes/8.0/active-active/create-reaadb/"},{"id":"edit-clusters","summary":"Steps to add or remove a participating cluster to an existing Active-Active database with Redis Enterprise for Kubernetes.","title":"Edit participating clusters for Active-Active database","url":"https://redis.io/docs/latest/operate/kubernetes/8.0/active-active/edit-clusters/"},{"id":"global-config","summary":"The REAADB contains the field '.spec.globalConfigurations' and through this the database configurations are set.","title":"Set global database configurations","url":"https://redis.io/docs/latest/operate/kubernetes/8.0/active-active/global-config/"},{"id":"global-db-secret","summary":"The REAADB contains the field '.spec.globalConfigurations' to set the global database secret.","title":"Set global database secret","url":"https://redis.io/docs/latest/operate/kubernetes/8.0/active-active/global-db-secret/"},{"id":"edit-rerc","summary":"Edit the configuration details of an existing RERC with Redis Enterprise for Kubernetes.","title":"Edit Redis Enterprise remote clusters","url":"https://redis.io/docs/latest/operate/kubernetes/8.0/active-active/edit-rerc/"},{"id":"create-aa-crdb-cli","summary":"This section shows how to set up an Active-Active Redis Enterprise database on Kubernetes using the Redis Enterprise Software operator.","title":"Create Active-Active databases with crdb-cli","url":"https://redis.io/docs/latest/operate/kubernetes/8.0/active-active/create-aa-crdb-cli/"}]
}
