{
  "id": "change-node-role",
  "title": "Change node roles",
  "url": "https://redis.io/docs/latest/operate/rs/8.0/clusters/change-node-role/",
  "summary": "Change node roles to demote the primary node to a secondary node or promote a secondary node to become the primary node.",
  "content": "\nA Redis Software cluster contains a primary node, which coordinates cluster-wide management operations, and multiple secondary nodes. Nodes with either role can host database shards.\n\n## Demote primary node\n\n**Cluster Manager UI:**\n\nTo demote the primary node to a secondary node using the Cluster Manager UI:\n\n1. On the **Nodes** screen, click the **More actions** button (**\u0026vellip;**) for the primary node you want to demote.\n\n    \u003cimg src=\"../../../../images/rs/screenshots/nodes/primary-node-more-actions.png\" alt=\"Click the more actions button for a node to access node actions.\"\u003e\n\n1. Select **Set as a secondary node** from the list.\n\n1. Select one of the options to determine the new primary node:\n\n    - **Automatically**: The cluster decides which node becomes the new primary node.\n\n    - **Choose specific node**: You can manually select which node becomes the new primary node.\n\n    \u003cimg src=\"../../../../images/rs/screenshots/nodes/primary-node-set-as-secondary-dialog.png\" alt=\"The Set as a secondary node dialog has two options to select the new primary node, either automatically or manually.\"\u003e\n\n1. Click **Confirm**.\n\n**rladmin:**\n\nTo demote the primary node to a secondary node using `rladmin`:\n\n1. Identify the primary node's ID with [`rladmin cluster master`](https://redis.io/docs/latest/operate/rs/references/cli-utilities/rladmin/cluster/master):\n\n    ```sh\n    $ rladmin cluster master\n    Node \u003cprimary-node-id\u003e is the cluster master node\n    ```\n\n1. Run [`rladmin node enslave`](https://redis.io/docs/latest/operate/rs/references/cli-utilities/rladmin/node/enslave/#node-enslave) with the `demote_node` option:\n\n    ```sh\n    rladmin node \u003cprimary-node-ID\u003e enslave demote_node\n    ```\n\n    Replace `\u003cprimary-node-ID\u003e` with the ID returned by `rladmin cluster master`.\n\n\n\n## Promote secondary node\n\n**Cluster Manager UI:**\n\nTo promote a secondary node to become the primary node using the Cluster Manager UI:\n\n1. On the **Nodes** screen, click the **More actions** button (**\u0026vellip;**) for the secondary node you want to promote.\n\n    \u003cimg src=\"../../../../images/rs/screenshots/nodes/secondary-nodes-more-actions.png\" alt=\"Click the more actions button for a node to access node actions.\"\u003e\n\n1. Select **Set as the primary node** from the list.\n\n1. Click **Confirm**.\n\n**rladmin:**\n\nTo promote a secondary node to become the primary node using `rladmin`:\n\n1. To find the IDs of secondary nodes, run [`rladmin status nodes`](https://redis.io/docs/latest/operate/rs/references/cli-utilities/rladmin/status#status-nodes):\n\n    ```sh\n    $ rladmin status nodes\n    CLUSTER NODES:\n    NODE:ID     ROLE       ADDRESS          EXTERNAL_ADDRESS          HOSTNAME            SHARDS     CORES          FREE_RAM                 PROVISIONAL_RAM          VERSION        STATUS   \n    node:1      master     198.51.100.2                                 3d99db1fdf4b        4/100      6              14.74GB/19.54GB          10.73GB/16.02GB          7.22.0-250     OK       \n    *node:3     slave      198.51.100.4                                 b87cc06c830f        0/100      6              14.74GB/19.54GB          11.22GB/16.02GB          7.22.0-250     OK       \n    node:2      slave      198.51.100.3                                 fc7a3d332458        0/100      6              14.74GB/19.54GB          11.22GB/16.02GB          7.22.0-250     OK       \n    ```\n\n    Nodes with the `slave` role are secondary nodes.\n\n1. Run [`rladmin cluster master set`](https://redis.io/docs/latest/operate/rs/references/cli-utilities/rladmin/cluster/master):\n\n    ```sh\n    rladmin cluster master set \u003csecondary-node-ID\u003e\n    ```\n\n    Replace `\u003csecondary-node-ID\u003e` with the ID of the secondary node you want to promote.\n\n\n\nAfter this node becomes the primary node, all cluster management traffic is directed to it.\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-07-23T11:57:56-05:00"
}