{
  "schema_version": 2,
  "id": "operate/rs/references/cli-utilities/crdb-cli",
  "title": "crdb-cli",
  "url": "https://redis.io/docs/latest/operate/rs/references/cli-utilities/crdb-cli/",
  "summary": "Manage Active-Active databases.",
  "tags": [
    "docs",
    "operate",
    "rs"
  ],
  "last_updated": "2026-10-05T17:53:21+03:00",
  "children": [
    {
      "id": "operate/rs/references/cli-utilities/crdb-cli/crdb",
      "summary": "Manage Active-Active databases.",
      "title": "crdb-cli crdb commands",
      "url": "https://redis.io/docs/latest/operate/rs/references/cli-utilities/crdb-cli/crdb/"
    },
    {
      "id": "operate/rs/references/cli-utilities/crdb-cli/task",
      "summary": "Manage Active-Active tasks.",
      "title": "crdb-cli task commands",
      "url": "https://redis.io/docs/latest/operate/rs/references/cli-utilities/crdb-cli/task/"
    }
  ],
  "page_type": "content",
  "content_hash": "2fdc9fae71aa575572a72b131f6e6ea59e9f588a333dec8e596df3a6b9634066",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "An [Active-Active database](https://redis.io/docs/latest/operate/rs/databases/active-active) (also known as CRDB or conflict-free replicated database)\nreplicates your data across Redis Software clusters located in geographically distributed regions.\nActive-Active databases allow read-write access in all locations, making them ideal for distributed applications that require fast response times and disaster recovery.\n\nThe Active-Active database on an individual cluster is called an **instance**.\nEach cluster that hosts an instance is called a **participating cluster**.\n\nAn Active-Active database requires two or more participating clusters.\nEach instance is responsible for updating the instances that reside on other participating clusters with the transactions it receives.\nWrite conflicts are resolved using [conflict-free replicated data types](https://redis.io/docs/latest/operate/rs/databases/active-active) (CRDTs).\n\nTo programmatically maintain an Active-Active database and its instances, you can use the `crdb-cli` command-line tool."
    },
    {
      "id": "crdb-cli-commands",
      "title": "`crdb-cli` commands",
      "role": "content",
      "text": "| Command | Description |\n| --- | --- |\n| [crdb](https://redis.io/docs/latest/operate/rs/references/cli-utilities/crdb-cli/crdb/) | Manage Active-Active databases. |\n| [task](https://redis.io/docs/latest/operate/rs/references/cli-utilities/crdb-cli/task/) | Manage Active-Active tasks. |"
    },
    {
      "id": "use-the-crdb-cli",
      "title": "Use the crdb-cli",
      "role": "content",
      "text": "To use the `crdb-cli` tool, use SSH to sign in to a Redis Software host with a user that belongs to the group that Redis Software was installed with (Default: **redislabs**).\nIf you sign in with a non-root user, you must add `/opt/redislabs/bin/` to your `PATH` environment variables.\n\n`crdb-cli` commands use the syntax: `crdb-cli <command> <arguments>` to let you:\n\n- Create, list, update, upgrade, flush, or delete an Active-Active database.\n- Add or remove an instance of the Active-Active database on a specific cluster.\n\nEach command creates a task.\n\nBy default, the command runs immediately and displays the result in the output.\n\nIf you use the <nobr>`--no-wait`</nobr> flag, the command runs in the background so that your application is not delayed by the response.\n\nUse the [`crdb-cli task` commands](https://redis.io/docs/latest/operate/rs/references/cli-utilities/crdb-cli/task) to manage Active-Active database tasks.\n\nFor each `crdb-cli` command, you can use <nobr>`--help`</nobr> for additional information about the command."
    }
  ],
  "examples": []
}