{
  "schema_version": 2,
  "id": "operate/rs/references/cli-utilities/rladmin/node/addr",
  "title": "rladmin node addr set",
  "url": "https://redis.io/docs/latest/operate/rs/references/cli-utilities/rladmin/node/addr/",
  "summary": "Sets a node's internal IP address.",
  "tags": [
    "docs",
    "operate",
    "rs"
  ],
  "last_updated": "2026-09-24T10:14:21+01:00",
  "page_type": "content",
  "content_hash": "181509abba44be4bdf59809fa0b44eb094a60b7ea529c8f97b898dfbbe4d1ed1",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "Sets the internal IP address of a node. You can only set the internal IP address when the node is down. See [Change internal IP address](https://redis.io/docs/latest/operate/rs/networking/multi-ip-ipv6#change-internal-ip-address) for detailed instructions.\n\n[code example]"
    },
    {
      "id": "parameters",
      "title": "Parameters",
      "role": "parameters",
      "text": "| Parameter | Type/Value                     | Description                                                                                   |\n|-----------|--------------------------------|-----------------------------------------------------------------------------------------------|\n| node      | integer                        | Sets the internal IP address of the specified node                                                |\n| addr   | IP address                     | Sets the node's internal IP address to the specified IP address                                      |"
    },
    {
      "id": "returns",
      "title": "Returns",
      "role": "returns",
      "text": "Returns `Updated successfully` if the IP address was 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 internal IP address was changed."
    },
    {
      "id": "example",
      "title": "Example",
      "role": "example",
      "text": "[code example]"
    }
  ],
  "examples": [
    {
      "id": "overview-ex0",
      "language": "sh",
      "code": "rladmin node <ID> addr set <IP address>",
      "section_id": "overview"
    },
    {
      "id": "example-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                   3d99db1fdf4b 5/100  6     16.06GB/19.54GB 12.46GB/16.02GB 6.2.12-37 OK\nnode:2  slave  192.0.2.3                   fc7a3d332458 0/100  6     -/19.54GB       -/16.02GB       6.2.12-37 DOWN, last seen 33s ago\nnode:3  slave  192.0.2.4                   b87cc06c830f 5/120  6     16.06GB/19.54GB 12.46GB/16.02GB 6.2.12-37 OK\n$ rladmin node 2 addr set 192.0.2.5\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                   3d99db1fdf4b 5/100  6     14.78GB/19.54GB 11.18GB/16.02GB 6.2.12-37 OK\nnode:2  slave  192.0.2.5                   fc7a3d332458 0/100  6     14.78GB/19.54GB 11.26GB/16.02GB 6.2.12-37 OK\nnode:3  slave  192.0.2.4                   b87cc06c830f 5/120  6     14.78GB/19.54GB 11.18GB/16.02GB 6.2.12-37 OK",
      "section_id": "example"
    }
  ]
}