{
  "id": "create",
  "title": "Create a database with Replica Of",
  "url": "https://redis.io/docs/latest/operate/rs/7.8/databases/import-export/replica-of/create/",
  "summary": "Create Replica Of database",
  "content": "Replica databases copy data from source databases (previously known as _master_), which enable read-only connections from apps and clients located in different geographic locations.\n\nTo create a replica connection, you define a database as a replica of a source database.  Replica Of databases (also known as _Active-Passive databases_) synchronize in the background.\n\nSources databases can be:\n\n- Located in the same Redis Enterprise Software cluster\n- Located in a different Redis Enterprise cluster\n- Hosted by a different deployment, e.g. Redis Cloud\n- Redis Open Source databases\n\nYour apps can connect to the source database to read and write data; they can also use any replica for read-only access.\n\nReplica Of can model a variety of data relationships, including:\n\n- One-to-many relationships, where multiple replicas copy a single source database.\n- Many-to-one relationships, where a single replica collects data from multiple source databases.\n\nWhen you change the replica status of a database by adding, removing, or changing sources, the replica database is synchronized to the new sources.  \n\n## Configure Replica Of\n\nYou can configure a database as a Replica Of, where the source database is in one of the following clusters:\n\n- [Same Redis Enterprise cluster](#same-cluster)\n\n- [Different Redis Enterprise cluster](#different-cluster)\n\n- [Redis Open Source cluster](#source-available-cluster)\n\nThe order of the multiple Replica Of sources has no material impact on replication.\n\nFor best results when using the [Multicast DNS](https://en.wikipedia.org/wiki/Multicast_DNS) (mDNS) protocol to resolve the fully-qualified domain name (FQDN) of the cluster, verify that your client connections meet the [client mDNS prerequisites]().\n\n\nAs long as Replica Of is enabled, data in the target database will not expire and will not be evicted regardless of the set [data eviction policy]().\n\n\n### Same Redis Enterprise cluster {#same-cluster}\n\nTo configure a Replica Of database in the same Redis Enterprise cluster as the source database:\n\n1. [Create a new database]() or select an existing database from the **Databases** screen.\n\n1. For an existing database, select **Edit** from the **Configuration** tab.\n\n1. Expand the **Replica Of** section.\n\n1. Select **+ Add source database**.\n\n1. In the **Connect a Replica Of source database** dialog, select **Current cluster**.\n\n1. Select the source database from the list.\n\n1. Select **Add source**.\n\n1. Select **Save**.\n\n### Different Redis Enterprise cluster {#different-cluster}\n\nTo configure a Replica Of database in a different Redis Enterprise cluster from the source database:\n\n1. Ensure the source database's port is allowed through firewalls between the clusters and can be accessed by the destination cluster's nodes.\n\n    \nPorts 10000-19999 are reserved for database traffic. See [Network port configurations]() for more information about ports.\n    \n\n1. Sign in to the Cluster Manager UI of the cluster hosting the source database.\n\n    1. In **Databases**, select the source database and then select the **Configuration** tab.\n\n    1. In the **Replica Of** section, select **Use this database as a source for another database**.\n\n    1. Copy the Replica Of source URL.\n\n        \n\n        To change the internal password, select **Regenerate password**.\n\n        If you regenerate the password, replication to existing destinations fails until their credentials are updated with the new password.\n\n1. Sign in to the Cluster Manager UI of the destination database's cluster.\n\n1. [Create a new database]() or select an existing database from the **Databases** screen.\n\n1. For an existing database, select **Edit** from the **Configuration** tab.\n\n1. Expand the **Replica Of** section.\n\n1. Select **+ Add source database**.\n\n1. In the **Connect a Replica Of source database** dialog, select **External**.\n\n1. Enter the URL of the source database endpoint.\n\n1. Select **Add source**.\n\n1. Select **Save**.\n\nFor source databases on different clusters, you can [compress replication data]() to save bandwidth.\n        \n### Redis Open Source cluster {#source-available-cluster}\n\nTo use a database from a Redis Open Source cluster as a Replica Of source:\n\n1. [Create a new database]() or select an existing database from the **Databases** screen.\n\n1. For an existing database, select **Edit** from the **Configuration** tab.\n\n1. Expand the **Replica Of** section.\n\n1. Select **+ Add source database**.\n\n1. In the **Connect a Replica Of source database** dialog, select **External**.\n\n1. Enter the URL of the source endpoint in one of the following formats:\n\n    - For databases with passwords:\n\n        ```sh\n        redis://:\u003cpassword\u003e@\u003chost\u003e:\u003cport\u003e\n        ```\n\n        Where the password is the Redis password represented with URL encoding escape characters.\n\n    - For databases without passwords:\n\n        ```sh\n        redis://\u003chost\u003e:\u003cport\u003e\n        ```\n\n1. Select **Add source**.\n\n1. Select **Save**.\n\n## Configure TLS for Replica Of\n\nWhen you enable TLS for Replica Of, the Replica Of synchronization traffic uses TLS certificates to authenticate the communication between the source and destination clusters.\n\nTo encrypt Replica Of synchronization traffic, configure encryption for the [source database](#encrypt-source-database-traffic) and the destination [replica database](#encrypt-replica-database-traffic).\n\n### Encrypt source database traffic\n\n\n\n### Encrypt replica database traffic\n\nTo enable TLS for Replica Of in the destination database:\n\n1. From the Cluster Manager UI of the cluster hosting the source database:\n\n    1. Go to **Cluster \u003e Security \u003e Certificates**.\n\n    1. Expand the **Server authentication (Proxy certificate)** section.\n\n        \n\n     1. Download or copy the proxy certificate.\n\n1. From the **Configuration** tab of the Replica Of destination database, select **Edit**.\n\n1. Expand the **Replica Of** section.\n\n1. Point to the source database entry and select  to edit it.\n\n1. Paste or upload the source proxy certificate, then select **Done**.\n\n1. Select **Save**.\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-04-01T08:10:08-05:00"
}