{
  "schema_version": 2,
  "id": "operate/rs/references/cli-utilities/rladmin/cluster/create",
  "title": "rladmin cluster create",
  "url": "https://redis.io/docs/latest/operate/rs/references/cli-utilities/rladmin/cluster/create/",
  "summary": "Creates a new cluster.",
  "tags": [
    "docs",
    "operate",
    "rs"
  ],
  "last_updated": "2025-05-19T15:06:21-05:00",
  "page_type": "content",
  "content_hash": "ded31ab18d6536c9ada189a92034673ec64e24fd22ccc25c32719961e6b1aaf5",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "Creates a new cluster. The node where you run `rladmin cluster create` becomes the first node of the new cluster.\n\n[code example]"
    },
    {
      "id": "parameters",
      "title": "Parameters",
      "role": "parameters",
      "text": "| Parameter | Type/Value | Description |\n|-----------|------------|-------------|\n| addr | IP address | The node's internal IP address (optional) |\n| ccs_persistent_path | filepath (default: /var/opt/redislabs/persist) | Path to the location of CCS snapshots (optional) |\n| ephemeral_path | filepath (default: /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: /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: /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| second_rack_id | string | The unique identifier of the node's second rack ID for two-dimensional rack awareness (optional) |\n| username | email address | Admin user's email address |"
    },
    {
      "id": "returns",
      "title": "Returns",
      "role": "returns",
      "text": "Returns `ok` if the new cluster was created successfully. Otherwise, it returns an error message."
    },
    {
      "id": "example",
      "title": "Example",
      "role": "example",
      "text": "[code example]"
    }
  ],
  "examples": [
    {
      "id": "overview-ex0",
      "language": "sh",
      "code": "cluster create\n        name <cluster name>\n        username <admin email>\n        password <admin password>\n        [ node_uid <node UID> ] \n        [ rack_aware ]\n        [ rack_id <node rack ID> ]\n        [ second_rack_id <node's second rack ID> ]\n        [ license_file <file> ]\n        [ ephemeral_path <path> ]\n        [ persistent_path <path> ]\n        [ ccs_persistent_path <path> ]\n        [ register_dns_suffix ]\n        [ flash_enabled ]\n        [ flash_path <path> ]\n        [ addr <IP.address> ]\n        [ external_addr <IP.address.1> [<IP.address.2> ... <IP.address.N>] ]",
      "section_id": "overview"
    },
    {
      "id": "example-ex0",
      "language": "sh",
      "code": "$ rladmin cluster create name cluster.local \\\n        username admin@example.com \\\n        password admin-password\nCreating a new cluster... ok",
      "section_id": "example"
    }
  ]
}