{
  "id": "external-addr",
  "title": "rladmin node external_addr",
  "url": "https://redis.io/docs/latest/operate/rs/7.8/references/cli-utilities/rladmin/node/external-addr/",
  "summary": "Configures a node's external IP addresses.",
  "content": "\nConfigures a node's external IP addresses.\n\n## `node external_addr add`\n\nAdds an external IP address that accepts inbound user connections for the node.\n\n```sh\nrladmin node \u003cID\u003e external_addr\n        add \u003cIP address\u003e\n```\n\n### Parameters\n\n| Parameter | Type/Value                     | Description                                                                                   |\n|-----------|--------------------------------|-----------------------------------------------------------------------------------------------|\n| node      | integer                        | Adds an external IP address for the specified node                                               |\n| IP address | IP address                     | External IP address of the node                                                               |\n\n### Returns\n\nReturns `Updated successfully` if the IP address was added. Otherwise, it returns an error.\n\nUse [`rladmin status nodes`]() to verify the external IP address was added.\n\n### Example\n\n``` sh\n$ rladmin node 1 external_addr add 198.51.100.1\nUpdated successfully.\n$ rladmin status nodes\nCLUSTER NODES:\nNODE:ID ROLE   ADDRESS   EXTERNAL_ADDRESS  HOSTNAME     SHARDS CORES       FREE_RAM         PROVISIONAL_RAM  VERSION   STATUS\n*node:1 master 192.0.2.2 198.51.100.1      3d99db1fdf4b 5/100  6           14.75GB/19.54GB  11.15GB/16.02GB  6.2.12-37 OK\nnode:2  slave  192.0.2.3                   fc7a3d332458 0/100  6           14.75GB/19.54GB  11.24GB/16.02GB  6.2.12-37 OK\nnode:3  slave  192.0.2.4                   b87cc06c830f 5/120  6           14.75GB/19.54GB  11.15GB/16.02GB  6.2.12-37 OK\n```\n\n## `node external_addr set`\n\nSets one or more external IP addresses that accepts inbound user connections for the node.\n\n```sh\nrladmin node \u003cID\u003e external_addr\n        set \u003cIP address 1\u003e ... \u003cIP address N\u003e\n```\n\n### Parameters\n\n| Parameter | Type/Value                     | Description                                                                                   |\n|-----------|--------------------------------|-----------------------------------------------------------------------------------------------|\n| node      | integer                        | Sets external IP addresses for the specified node                                             |\n| IP address | list of IP addresses           | Sets specified IP addresses as external addresses                                                 |\n\n### Returns\n\nReturns `Updated successfully` if the IP addresses were set. Otherwise, it returns an error.\n\nUse [`rladmin status nodes`]() to verify the external IP address was set.\n\n### Example\n\n``` sh\n$ rladmin node 2 external_addr set 198.51.100.2 198.51.100.3\nUpdated successfully.\n$ rladmin status nodes\nCLUSTER NODES:\nNODE:ID ROLE   ADDRESS   EXTERNAL_ADDRESS          HOSTNAME     SHARDS CORES FREE_RAM        PROVISIONAL_RAM VERSION   STATUS\n*node:1 master 192.0.2.2 198.51.100.1              3d99db1fdf4b 5/100  6     14.75GB/19.54GB 11.15GB/16.02GB 6.2.12-37 OK\nnode:2  slave  192.0.2.3 198.51.100.2,198.51.100.3 fc7a3d332458 0/100  6     14.75GB/19.54GB 11.23GB/16.02GB 6.2.12-37 OK\nnode:3  slave  192.0.2.4                           b87cc06c830f 5/120  6     14.75GB/19.54GB 11.15GB/16.02GB 6.2.12-37 OK\n```\n## `node external_addr remove`\n\nRemoves the specified external IP address from the node.\n\n```sh\nrladmin node \u003cID\u003e external_addr\n        remove \u003cIP address\u003e\n```\n\n### Parameters\n\n| Parameter | Type/Value                     | Description                                                                                   |\n|-----------|--------------------------------|-----------------------------------------------------------------------------------------------|\n| node      | integer                        | Removes an external IP address for the specified node                                            |\n| IP address | IP address                     | Removes the specified IP address of the node                                                      |\n\n### Returns\n\nReturns `Updated successfully` if the IP address was removed. Otherwise, it returns an error.\n\nUse [`rladmin status nodes`]() to verify the external IP address was removed.\n\n### Example\n\n``` sh\n$ rladmin status nodes\nCLUSTER NODES:\nNODE:ID ROLE   ADDRESS   EXTERNAL_ADDRESS          HOSTNAME     SHARDS CORES FREE_RAM        PROVISIONAL_RAM VERSION   STATUS\n*node:1 master 192.0.2.2 198.51.100.1              3d99db1fdf4b 5/100  6     14.75GB/19.54GB 11.15GB/16.02GB 6.2.12-37 OK\nnode:2  slave  192.0.2.3 198.51.100.2,198.51.100.3 fc7a3d332458 0/100  6     14.75GB/19.54GB 11.23GB/16.02GB 6.2.12-37 OK\nnode:3  slave  192.0.2.4                           b87cc06c830f 5/120  6     14.75GB/19.54GB 11.15GB/16.02GB 6.2.12-37 OK\n$ rladmin node 2 external_addr remove 198.51.100.3\nUpdated successfully.\n$ rladmin status nodes\nCLUSTER NODES:\nNODE:ID ROLE   ADDRESS   EXTERNAL_ADDRESS  HOSTNAME     SHARDS CORES       FREE_RAM         PROVISIONAL_RAM  VERSION   STATUS\n*node:1 master 192.0.2.2 198.51.100.1      3d99db1fdf4b 5/100  6           14.74GB/19.54GB  11.14GB/16.02GB  6.2.12-37 OK    \nnode:2  slave  192.0.2.3 198.51.100.2      fc7a3d332458 0/100  6           14.74GB/19.54GB  11.22GB/16.02GB  6.2.12-37 OK    \nnode:3  slave  192.0.2.4                   b87cc06c830f 5/120  6           14.74GB/19.54GB  11.14GB/16.02GB  6.2.12-37 OK    \n```\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-04-01T08:10:08-05:00"
}