{
  "id": "remove-instance",
  "title": "crdb-cli crdb remove-instance",
  "url": "https://redis.io/docs/latest/operate/rs/7.8/references/cli-utilities/crdb-cli/crdb/remove-instance/",
  "summary": "Removes a peer replica from an Active-Active database.",
  "content": "\nRemoves a peer replica instance from the Active-Active database and deletes the instance and its data from the participating cluster.\n\n```sh\ncrdb-cli crdb remove-instance --crdb-guid \u003cguid\u003e\n         --instance-id \u003cinstance-id\u003e\n         [ --force ]\n         [ --no-wait ]\n```\n\nIf the cluster cannot communicate with the instance that you want to remove, you can:\n\n1. Use the `--force` option to remove the instance from the Active-Active database without purging the data from the instance.\n\n1. Run [`crdb-cli crdb purge-instance`]() from the removed instance to delete the Active-Active database and its data.\n\n### Parameters\n\n| Parameter                    | Value  | Description|\n|------------------------------|--------|------------|\n| crdb-guid         | string | The GUID of the database (required) |\n| instance-id | string | The ID of the local instance to remove (required) |\n| force                        |        | Removes the instance without purging data from the instance. \u003cbr\u003eIf --force is specified, you must run [`crdb-cli crdb purge-instance`]() from the removed instance. |\n| no-wait                      |        | Does not wait for the task to complete |\n\n### Returns\n\nReturns the task ID of the task that is deleting the instance.\n\nIf `--no-wait` is specified, the command exits. Otherwise, it will wait for the instance to be removed and return `finished`.\n\n### Example\n\n```sh\n$ crdb-cli crdb remove-instance --crdb-guid db6365b5-8aca-4055-95d8-7eb0105c0b35 --instance-id 2 --force\nTask b1eba5ba-90de-49e9-8678-d66daa1afb51 created\n  ---\u003e Status changed: queued -\u003e started\n  ---\u003e Status changed: started -\u003e finished\n```\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-04-01T08:10:08-05:00"
}