{
  "id": "get-started",
  "title": "Get started with Redis Enterprise Active-Active databases",
  "url": "https://redis.io/docs/latest/operate/rs/7.8/databases/active-active/get-started/",
  "summary": "Quick start guide to create an Active-Active database for test and development.",
  "content": "\nTo get started, this article will help you set up an Active-Active database, formerly known as CRDB (conflict-free replicated database), spanning across two Redis Enterprise Software\nclusters for test and development environments. Here are the steps:\n\n1. Run two Redis Enterprise Software Docker containers.\n\n1. Set up each container as a cluster.\n\n1. Create a new Redis Enterprise Active-Active database.\n\n1. Test connectivity to the Active-Active database.\n\nTo run an Active-Active database on installations from the [Redis Enterprise Software download package](),\nset up two Redis Enterprise Software installations and continue from Step 2.\n\n\nThis getting started guide is for development or demonstration environments.\nFor production environments, see [Create an Active-Active geo-replicated database]() for instructions.\n\n\n## Run two containers\n\nTo spin up two Redis Enterprise Software containers, run these commands:\n\n```sh\ndocker run -d --cap-add sys_resource -h rs1_node1 --name rs1_node1 -p 8443:8443 -p 9443:9443 -p 12000:12000 redislabs/redis\n```\n\n```sh\ndocker run -d --cap-add sys_resource -h rs2_node1 --name rs2_node1 -p 8445:8443 -p 9445:9443 -p 12002:12000 redislabs/redis\n```\n\nThe **-p** options map the Cluster Manager UI port (8443), REST API port (9443), and\ndatabase access port differently for each container to make sure that all\ncontainers can be accessed from the host OS that is running the containers.\n\n## Set up two clusters\n\n1. For cluster 1, go to `https://localhost:8443` in a browser on the\nhost machine to access the Redis Enterprise Software Cluster Manager UI.\n\n    \nDepending on your browser, you may see a certificate error. Continue to the website.\n    \n\n1. Click **Create new cluster**:\n\n    \n\n1. Enter an email and password for the administrator account, then click **Next** to proceed to cluster setup:\n\n    \n\n1. Enter your cluster license key if you have one. Otherwise, a trial version is installed.\n\n    \n\n1. In the **Configuration** section of the **Cluster** settings page, enter a cluster FQDN, for example `cluster1.local`:\n\n    \n\n1. On the node setup screen, keep the default settings and click **Create cluster**:\n\n    \n\n1. Click **OK** to confirm that you are aware of the replacement of the HTTPS SSL/TLS\n    certificate on the node, and proceed through the browser warning.\n\n1. Repeat the previous steps for cluster 2 with these differences:\n\n    - In your web browser, go to `https://localhost:8445` to set up the cluster 2.\n\n    - For the **Cluster name (FQDN)**, enter a different name, such as `cluster2.local`.\n\nNow you have two Redis Enterprise Software clusters with FQDNs\n`cluster1.local` and `cluster2.local`.\n\n\nEach Active-Active instance must have a unique fully-qualified domain name (FQDN).\n\n\n## Create an Active-Active database\n\n1. Sign in to cluster1.local's Cluster Manager UI at `https://localhost:8443`\n\n1. Open the **Create database** menu with one of the following methods:\n\n    - Click the **+** button next to **Databases** in the navigation menu:\n\n        \n        \n    - Go to the **Databases** screen and select **Create database**:\n\n        \n\n1. Select **Active-Active database**.\n\n1. Enter the cluster's local admin credentials, then click **Save**:\n\n    \n\n1. Add participating clusters that will host instances of the Active-Active database:\n\n    1. In the **Participating clusters** section, go to **Other participating clusters** and click **+ Add cluster**.\n\n    1. In the **Add cluster** configuration panel, enter the new cluster's URL, port number, and the admin username and password for the new participating cluster:\n\n        In the **Other participating clusters** list, add the address and admin credentials for the other cluster: `https://cluster2.local:9443`\n\n        \n\n    1. Click **Join cluster** to add the cluster to the list of participating clusters. \n\n1. Enter `database1` for **Database name** and `12000` for **Port**:\n\n    \n\n1. Configure additional settings:\n\n    1. In the **High availability** section, turn off **Replication** since each cluster has only one node in this setup:\n\n        \n\n\n    1. In the **Clustering** section, either:\n\n        - Make sure that **Sharding** is enabled and select the number of shards you want to have in the database. When database clustering is enabled,\n        databases are subject to limitations on [Multi-key commands]().\n        You can increase the number of shards in the database at any time.\n\n        - Turn off **Sharding** to use only one shard and avoid [Multi-key command]() limitations.\n\n        \nYou cannot enable or turn off database clustering after the Active-Active database is created.\n        \n\n1. Click **Create**.\n\n    \n\n    \n\n1. After the Active-Active database is created, sign in to the Cluster Manager UIs for cluster 1 at `https://localhost:8443` and cluster 2 at `https://localhost:8445`.\n\n1. Make sure each cluster has an Active-Active database member database with the name `database1`.\n\n    In a real-world deployment, cluster 1 and cluster 2 would most likely be\n    in separate data centers in different regions. However, for\n    local testing we created the scale-minimized deployment using two\n    local clusters running on the same host.\n\n\u003c!-- Also in getting-started-crdbs.md --\u003e\n## Test connection\n\nWith the Redis database created, you are ready to connect to your\ndatabase. See [Connect to Active-Active databases]() for tutorials and examples of multiple connection methods.\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-04-01T08:10:08-05:00"
}