{
  "id": "create",
  "title": "rladmin cluster create",
  "url": "https://redis.io/docs/latest/operate/rs/7.8/references/cli-utilities/rladmin/cluster/create/",
  "summary": "Creates a new cluster.",
  "content": "\nCreates a new cluster. The node where you run `rladmin cluster create` becomes the first node of the new cluster.\n\n```sh\ncluster create\n        name \u003ccluster name\u003e\n        username \u003cadmin email\u003e\n        password \u003cadmin password\u003e\n        [ node_uid \u003cnode UID\u003e ] \n        [ rack_aware ]\n        [ rack_id \u003cnode rack ID\u003e ]\n        [ license_file \u003cfile\u003e ]\n        [ ephemeral_path \u003cpath\u003e ]\n        [ persistent_path \u003cpath\u003e ]\n        [ ccs_persistent_path \u003cpath\u003e ]\n        [ register_dns_suffix ]\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```\n\n### Parameters\n\n| Parameter | Type/Value | Description |\n|-----------|------------|-------------|\n| addr | IP address | The node's internal IP address (optional) |\n| ccs_persistent_path | filepath (default:\u0026nbsp;/var/opt/redislabs/persist) | Path to the location of CCS snapshots (optional) |\n| ephemeral_path | filepath (default:\u0026nbsp;/var/opt/redislabs) | Path to the ephemeral storage location (optional) |\n| external_addr | list of IP addresses | A space-delimited list of the node's external IP addresses (optional) |\n| flash_enabled | | Enables flash storage (optional) |\n| flash_path | filepath (default:\u0026nbsp;/var/opt/redislabs/flash) | Path to the flash storage location (optional) |\n| license_file | filepath | Path to the RLEC license file (optional) |\n| name | string | Cluster name |\n| node_uid | integer | Unique node ID (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_aware | | Activates or deactivates rack awareness (optional) |\n| rack_id | string | The rack's unique identifier (optional) |\n| register_dns_suffix | | Enables database mapping to both internal and external IP addresses (optional) |\n| username | email address | Admin user's email address |\n\n### Returns\n\nReturns `ok` if the new cluster was created successfully. Otherwise, it returns an error message.\n\n### Example\n\n```sh\n$ rladmin cluster create name cluster.local \\\n        username admin@example.com \\\n        password admin-password\nCreating a new cluster... ok\n```\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-04-01T08:10:08-05:00"
}