{
  "id": "join",
  "title": "rladmin cluster join",
  "url": "https://redis.io/docs/latest/operate/rs/7.8/references/cli-utilities/rladmin/cluster/join/",
  "summary": "Adds a node to an existing cluster.",
  "content": "\nAdds a node to an existing cluster.\n\n```sh\nrladmin cluster join\n        nodes \u003cnode IP address\u003e\n        username \u003cadmin user email\u003e\n        password \u003cadmin password\u003e\n        [ ephemeral_path \u003cpath\u003e ]\n        [ persistent_path \u003cpath\u003e ]\n        [ ccs_persistent_path \u003cpath\u003e ]\n        [ rack_id \u003cnode rack ID\u003e ]\n        [ override_rack_id ]\n        [ replace_node \u003cnode UID\u003e ]\n        [ flash_enabled ]\n        [ flash_path \u003cpath\u003e ]\n        [ addr \u003cIP.address\u003e ]\n        [ external_addr \u003cIP.address.1\u003e [\u003cIP.address.2\u003e ... \u003cIP.address.N\u003e] ]\n        [ override_repair ]\n        [ accept_servers { enabled | disabled } ]\n        [ cnm_http_port \u003cport\u003e ]\n```\n\n### Parameters\n\n| Parameter | Type/Value | Description |\n|-----------|------------|-------------|\n| accept_servers | 'enabled'\u003cbr /\u003e'disabled' | Allows allocation of resources on the new node when enabled (optional) |\n| addr | IP address | Sets a node's internal IP address. If not provided, the node sets the address automatically. (optional) |\n| ccs_persistent_path | filepath (default:\u0026nbsp;/var/opt/redislabs/persist) | Path to the CCS snapshot location (the default is the same as persistent_path) (optional) |\n| cnm_http_port | integer | Joins a cluster that has a non-default cnm_http_port (optional) |\n| ephemeral_path | filepath | Path to the ephemeral storage location (optional) |\n| external_addr | list of IP addresses | Sets a node's external IP addresses (space-delimited list). If not provided, the node sets the address automatically. (optional) |\n| flash_enabled |  | Enables flash capabilities for a database (optional) |\n| flash_path | filepath (default:\u0026nbsp;/var/opt/redislabs/flash) | Path to the flash storage location in case the node does not support CAPI (required if flash_enabled) |\n| nodes | IP address | Internal IP address of an existing node in the cluster |\n| override_rack_id |  | Changes to a new rack, specified by `rack_id` (optional) |\n| override_repair |  | Enables joining a cluster with a dead node (optional) |\n| password | string | Admin user's password |\n| persistent_path | filepath (default:\u0026nbsp;/var/opt/redislabs/persist) | Path to the persistent storage location (optional) |\n| rack_id | string | Moves the node to the specified rack (optional) |\n| replace_node | integer | Replaces the specified node with the new node (optional) |\n| username | email address | Admin user's email address |\n\n### Returns\n\nReturns `ok` if the node joined the cluster successfully. Otherwise, it returns an error message.\n\n### Example\n\n```sh\n$ rladmin cluster join nodes 192.0.2.2 \\\n        username admin@example.com \\\n        password admin-password\nJoining cluster... ok\n```\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-04-01T08:10:08-05:00"
}