{
  "id": "purge-instance",
  "title": "crdb-cli crdb purge-instance",
  "url": "https://redis.io/docs/latest/operate/rs/7.8/references/cli-utilities/crdb-cli/crdb/purge-instance/",
  "summary": "Deletes data from a local instance and removes it from the Active-Active database.",
  "content": "\nDeletes data from a local instance and removes the instance from the Active-Active database.\n\n```sh\ncrdb-cli crdb purge-instance --crdb-guid \u003cguid\u003e\n         --instance-id \u003cinstance-id\u003e\n         [ --no-wait ]\n```\n\nOnce this command finishes, the other replicas must remove this instance with [`crdb-cli crdb remove-instance --force`]().\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 (required) |\n| no-wait                   |        | Does not wait for the task to complete           |\n\n### Returns\n\nReturns the task ID of the task that is purging the local instance.\n\nIf `--no-wait` is specified, the command exits. Otherwise, it will wait for the instance to be purged and return `finished`.\n\n### Example\n\n```sh\n$ crdb-cli crdb purge-instance --crdb-guid db6365b5-8aca-4055-95d8-7eb0105c0b35 --instance-id 2\nTask add0705c-87f1-4c28-ad6a-ab5d98e00c58 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"
}