{
  "schema_version": 2,
  "id": "operate/rs/references/cli-utilities/crdb-cli/crdb/purge-instance",
  "title": "crdb-cli crdb purge-instance",
  "url": "https://redis.io/docs/latest/operate/rs/references/cli-utilities/crdb-cli/crdb/purge-instance/",
  "summary": "Deletes data from a local instance and removes it from the Active-Active database.",
  "tags": [
    "docs",
    "operate",
    "rs"
  ],
  "last_updated": "2026-09-24T10:14:21+01:00",
  "page_type": "content",
  "content_hash": "c54b73dfa4537274dcb8302e3bf9d5bba377e0cf153909d6014aa02cb3d3be4a",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "Deletes data from a local instance and removes the instance from the Active-Active database.\n\n[code example]\n\nOnce this command finishes, the other replicas must remove this instance with [`crdb-cli crdb remove-instance --force`](https://redis.io/docs/latest/operate/rs/references/cli-utilities/crdb-cli/crdb/remove-instance)."
    },
    {
      "id": "parameters",
      "title": "Parameters",
      "role": "parameters",
      "text": "| 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           |"
    },
    {
      "id": "returns",
      "title": "Returns",
      "role": "returns",
      "text": "Returns 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`."
    },
    {
      "id": "example",
      "title": "Example",
      "role": "example",
      "text": "[code example]"
    }
  ],
  "examples": [
    {
      "id": "overview-ex0",
      "language": "sh",
      "code": "crdb-cli crdb purge-instance --crdb-guid <guid>\n         --instance-id <instance-id>\n         [ --no-wait ]",
      "section_id": "overview"
    },
    {
      "id": "example-ex0",
      "language": "sh",
      "code": "$ crdb-cli crdb purge-instance --crdb-guid db6365b5-8aca-4055-95d8-7eb0105c0b35 --instance-id 2\nTask add0705c-87f1-4c28-ad6a-ab5d98e00c58 created\n  ---> Status changed: queued -> started\n  ---> Status changed: started -> finished",
      "section_id": "example"
    }
  ]
}