{
  "schema_version": 2,
  "id": "operate/kubernetes/active-active",
  "title": "Active-Active databases",
  "url": "https://redis.io/docs/latest/operate/kubernetes/7.4.6/active-active/",
  "summary": "Content related to Active-Active Redis Enterprise databases for Kubernetes.",
  "content": "\nOn Kubernetes, Redis Enterprise [Active-Active](https://redis.io/docs/latest/operate/rs/databases/active-active) databases provide read and write access to the same dataset from different Kubernetes clusters.\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\n\u003e [!NOTE]\n\u003e These 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### Preview versions\n\nIf you are using a preview version of these features (operator version 6.4.2-4 or 6.4.2-5), you'll need to enable the Active-Active controller with the following steps. You need to do this only once per cluster. We recommend using the fully supported 6.4.2-6 version.\n\n1. Download the custom resource definitions (CRDs) for the most recent release (6.4.2-4) from [redis-enterprise-k8s-docs Github](https://github.com/RedisLabs/redis-enterprise-k8s-docs/tree/master/crds).\n\n1. Apply the new CRDs for the Redis Enterprise Active-Active database (REAADB) and Redis Enterprise remote cluster (RERC) to install those controllers.\n\n    ```sh\n    kubectl apply -f crds/reaadb_crd.yaml\n    kubectl apply -f crds/rerc_crd.yaml\n    ```\n\n1. Enable the Active-Active and remote cluster controllers on the operator ConfigMap.\n\n    ```sh\n    kubectl patch cm  operator-environment-config --type merge --patch \"{\\\"data\\\": \\\n    {\\\"ACTIVE_ACTIVE_DATABASE_CONTROLLER_ENABLED\\\":\\\"true\\\", \\\n    \\\"REMOTE_CLUSTER_CONTROLLER_ENABLED\\\":\\\"true\\\"}}\"\n\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/redis_enterprise_active_active_database_api).\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/redis_enterprise_remote_cluster_api).\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\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-10-22T06:20:54-07:00",
  "children": [{"id":"operate/kubernetes/active-active/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/7.4.6/active-active/prepare-clusters/"},{"id":"operate/kubernetes/active-active/create-reaadb","summary":"","title":"Create Active-Active database (REAADB)","url":"https://redis.io/docs/latest/operate/kubernetes/7.4.6/active-active/create-reaadb/"},{"id":"operate/kubernetes/active-active/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/7.4.6/active-active/edit-clusters/"},{"id":"operate/kubernetes/active-active/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/7.4.6/active-active/global-config/"},{"id":"operate/kubernetes/active-active/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/7.4.6/active-active/global-db-secret/"},{"id":"operate/kubernetes/active-active/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/7.4.6/active-active/edit-rerc/"},{"id":"operate/kubernetes/active-active/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/7.4.6/active-active/create-aa-crdb-cli/"}]
}