{
  "id": "crdb-cli",
  "title": "crdb-cli",
  "url": "https://redis.io/docs/latest/operate/rs/7.8/references/cli-utilities/crdb-cli/",
  "summary": "Manage Active-Active databases.",
  "content": "\nAn [Active-Active database]() (also known as CRDB or conflict-free replicated database)\nreplicates your data across Redis Enterprise 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]() (CRDTs).\n\nTo programmatically maintain an Active-Active database and its instances, you can use the `crdb-cli` command-line tool.\n\n## `crdb-cli` commands\n\n\n\n## Use the crdb-cli\n\nTo use the `crdb-cli` tool, use SSH to sign in to a Redis Enterprise host with a user that belongs to the group that Redis Enterprise 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 \u003ccommand\u003e \u003carguments\u003e` to let you:\n\n- Create, list, update, 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 \u003cnobr\u003e`--no-wait`\u003c/nobr\u003e flag, the command runs in the background so that your application is not delayed by the response.\n\nUse the [`crdb-cli task` commands]() to manage Active-Active database tasks.\n\nFor each `crdb-cli` command, you can use \u003cnobr\u003e`--help`\u003c/nobr\u003e for additional information about the command.\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-04-01T08:10:08-05:00",
  "children": [{"id":"crdb","summary":"Manage Active-Active databases.","title":"crdb-cli crdb commands","url":"https://redis.io/docs/latest/operate/rs/7.8/references/cli-utilities/crdb-cli/crdb/"},{"id":"task","summary":"Manage Active-Active tasks.","title":"crdb-cli task commands","url":"https://redis.io/docs/latest/operate/rs/7.8/references/cli-utilities/crdb-cli/task/"}]
}