{
  "id": "get-started",
  "title": "Get started with Redis Software Active-Active databases",
  "url": "https://redis.io/docs/latest/operate/rs/8.0/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 Software\nclusters for test and development environments. Here are the steps:\n\n1. Run two Redis Software Docker containers.\n\n1. Set up each container as a cluster.\n\n1. Create a new Redis Software Active-Active database.\n\n1. Test connectivity to the Active-Active database.\n\nTo run an Active-Active database on installations from the [Redis Software download package](https://redis.io/docs/latest/operate/rs/installing-upgrading/quickstarts/redis-enterprise-software-quickstart),\nset up two Redis 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](https://redis.io/docs/latest/operate/rs/databases/active-active/create) for instructions.\n\n\n## Run two containers\n\nTo spin up two Redis 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\n\nThe `-h` option sets the hostname of the container, which is important for cluster setup and identification.\n\nThe `--name` option assigns a name to the container, making it easier to manage and reference with Docker commands.\n\nThe `-p` options map the Cluster Manager UI port (8443), REST API port (9443), and database access port differently for each container to make sure that all containers can be accessed from the host OS that is running the containers.\n\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 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    ![images/rs/screenshots/cluster/setup/create-cluster.png](https://redis.io/docs/latest/images/rs/screenshots/cluster/setup/create-cluster.png)\n\n1. Enter an email and password for the administrator account, then click **Next** to proceed to cluster setup:\n\n    ![images/rs/screenshots/cluster/setup/admin-credentials.png](https://redis.io/docs/latest/images/rs/screenshots/cluster/setup/admin-credentials.png)\n\n1. Enter your cluster license key if you have one. Otherwise, a trial version is installed.\n\n    ![images/rs/screenshots/cluster/setup/cluster-license-key.png](https://redis.io/docs/latest/images/rs/screenshots/cluster/setup/cluster-license-key.png)\n\n1. In the **Configuration** section of the **Cluster** settings page, enter a cluster FQDN, for example `cluster1.local`:\n\n    ![images/rs/screenshots/cluster/setup/config-cluster1.png](https://redis.io/docs/latest/images/rs/screenshots/cluster/setup/config-cluster1.png)\n\n1. On the node setup screen, keep the default settings and click **Create cluster**:\n\n    ![images/rs/screenshots/cluster/setup/node-settings.png](https://redis.io/docs/latest/images/rs/screenshots/cluster/setup/node-settings.png)\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 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        ![images/rs/screenshots/databases/create-db-plus-drop-down.png](https://redis.io/docs/latest/images/rs/screenshots/databases/create-db-plus-drop-down.png)\n        \n    - Go to the **Databases** screen and select **Create database**:\n\n        ![images/rs/screenshots/databases/create-db-button-drop-down.png](https://redis.io/docs/latest/images/rs/screenshots/databases/create-db-button-drop-down.png)\n\n1. Select **Active-Active database**.\n\n1. Enter the cluster's local admin credentials, then click **Save**:\n\n    ![images/rs/screenshots/databases/active-active-databases/enter-local-admin-credentials-cluster1.png](https://redis.io/docs/latest/images/rs/screenshots/databases/active-active-databases/enter-local-admin-credentials-cluster1.png)\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        ![images/rs/screenshots/databases/active-active-databases/participating-clusters-add-cluster2.png](https://redis.io/docs/latest/images/rs/screenshots/databases/active-active-databases/participating-clusters-add-cluster2.png)\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    ![images/rs/screenshots/databases/active-active-databases/quickstart-db-name-port.png](https://redis.io/docs/latest/images/rs/screenshots/databases/active-active-databases/quickstart-db-name-port.png)\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        ![images/rs/screenshots/databases/active-active-databases/quickstart-ha-turn-off-replication-7-8-2.png](https://redis.io/docs/latest/images/rs/screenshots/databases/active-active-databases/quickstart-ha-turn-off-replication-7-8-2.png)\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](https://redis.io/docs/latest/operate/rs/databases/durability-ha/clustering).\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](https://redis.io/docs/latest/operate/rs/databases/durability-ha/clustering) 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    \nIf you cannot activate the database because of a memory limitation,\nmake sure that Docker has at least 4 GB of memory allocated in the **Advanced** section of Docker **Settings**.\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](https://redis.io/docs/latest/operate/rs/databases/active-active/connect) for tutorials and examples of multiple connection methods.\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-07-23T15:55:14+01:00"
}