{
  "schema_version": 2,
  "id": "operate/rs/references/cli-utilities/rladmin/node/external-addr",
  "title": "rladmin node external_addr",
  "url": "https://redis.io/docs/latest/operate/rs/references/cli-utilities/rladmin/node/external-addr/",
  "summary": "Configures a node's external IP addresses.",
  "tags": [
    "docs",
    "operate",
    "rs"
  ],
  "last_updated": "2026-09-24T10:14:21+01:00",
  "page_type": "content",
  "content_hash": "9829b2716861a8fe9479e6e129c5d448a16eee639dc024b1efce5e9a5ae2ab51",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "Configures a node's external IP addresses."
    },
    {
      "id": "node-external_addr-add",
      "title": "`node external_addr add`",
      "role": "content",
      "text": "Adds an external IP address that accepts inbound user connections for the node.\n\n[code example]"
    },
    {
      "id": "parameters",
      "title": "Parameters",
      "role": "parameters",
      "text": "| 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                                                               |"
    },
    {
      "id": "returns",
      "title": "Returns",
      "role": "returns",
      "text": "Returns `Updated successfully` if the IP address was added. Otherwise, it returns an error.\n\nUse [`rladmin status nodes`](https://redis.io/docs/latest/operate/rs/references/cli-utilities/rladmin/status#status-nodes) to verify the external IP address was added."
    },
    {
      "id": "example",
      "title": "Example",
      "role": "example",
      "text": "[code example]"
    },
    {
      "id": "node-external_addr-set",
      "title": "`node external_addr set`",
      "role": "content",
      "text": "Sets one or more external IP addresses that accepts inbound user connections for the node.\n\n[code example]"
    },
    {
      "id": "parameters-1",
      "title": "Parameters",
      "role": "parameters",
      "text": "| 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                                                 |"
    },
    {
      "id": "returns-1",
      "title": "Returns",
      "role": "returns",
      "text": "Returns `Updated successfully` if the IP addresses were set. Otherwise, it returns an error.\n\nUse [`rladmin status nodes`](https://redis.io/docs/latest/operate/rs/references/cli-utilities/rladmin/status#status-nodes) to verify the external IP address was set."
    },
    {
      "id": "example-1",
      "title": "Example",
      "role": "example",
      "text": "[code example]"
    },
    {
      "id": "node-external_addr-remove",
      "title": "`node external_addr remove`",
      "role": "content",
      "text": "Removes the specified external IP address from the node.\n\n[code example]"
    },
    {
      "id": "parameters-2",
      "title": "Parameters",
      "role": "parameters",
      "text": "| 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                                                      |"
    },
    {
      "id": "returns-2",
      "title": "Returns",
      "role": "returns",
      "text": "Returns `Updated successfully` if the IP address was removed. Otherwise, it returns an error.\n\nUse [`rladmin status nodes`](https://redis.io/docs/latest/operate/rs/references/cli-utilities/rladmin/status#status-nodes) to verify the external IP address was removed."
    },
    {
      "id": "example-2",
      "title": "Example",
      "role": "example",
      "text": "[code example]"
    }
  ],
  "examples": [
    {
      "id": "node-external_addr-add-ex0",
      "language": "sh",
      "code": "rladmin node <ID> external_addr\n        add <IP address>",
      "section_id": "node-external_addr-add"
    },
    {
      "id": "example-ex0",
      "language": " sh",
      "code": "$ 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",
      "section_id": "example"
    },
    {
      "id": "node-external_addr-set-ex0",
      "language": "sh",
      "code": "rladmin node <ID> external_addr\n        set <IP address 1> ... <IP address N>",
      "section_id": "node-external_addr-set"
    },
    {
      "id": "example-1-ex0",
      "language": " sh",
      "code": "$ 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",
      "section_id": "example-1"
    },
    {
      "id": "node-external_addr-remove-ex0",
      "language": "sh",
      "code": "rladmin node <ID> external_addr\n        remove <IP address>",
      "section_id": "node-external_addr-remove"
    },
    {
      "id": "example-2-ex0",
      "language": " sh",
      "code": "$ 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",
      "section_id": "example-2"
    }
  ]
}