{
  "schema_version": 2,
  "id": "operate/rs/references/cli-utilities/crdb-cli/crdb/remove-instance",
  "title": "crdb-cli crdb remove-instance",
  "url": "https://redis.io/docs/latest/operate/rs/references/cli-utilities/crdb-cli/crdb/remove-instance/",
  "summary": "Removes a peer replica from an Active-Active database.",
  "tags": [
    "docs",
    "operate",
    "rs"
  ],
  "last_updated": "2026-09-24T10:14:21+01:00",
  "page_type": "content",
  "content_hash": "bdd8ad366787b0025f44b9c92ee0fed45980a9eddf10ff45a00fde1a3e3a224b",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "Removes a peer replica instance from the Active-Active database and deletes the instance and its data from the participating cluster.\n\n[code example]\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`](https://redis.io/docs/latest/operate/rs/references/cli-utilities/crdb-cli/crdb/purge-instance) from the removed instance to delete the Active-Active database and its data."
    },
    {
      "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 to remove (required) |\n| force                        |        | Removes the instance without purging data from the instance. <br>If --force is specified, you must run [`crdb-cli crdb purge-instance`](https://redis.io/docs/latest/operate/rs/references/cli-utilities/crdb-cli/crdb/purge-instance) from the removed instance. |\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 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`."
    },
    {
      "id": "example",
      "title": "Example",
      "role": "example",
      "text": "[code example]"
    }
  ],
  "examples": [
    {
      "id": "overview-ex0",
      "language": "sh",
      "code": "crdb-cli crdb remove-instance --crdb-guid <guid>\n         --instance-id <instance-id>\n         [ --force ]\n         [ --no-wait ]",
      "section_id": "overview"
    },
    {
      "id": "example-ex0",
      "language": "sh",
      "code": "$ crdb-cli crdb remove-instance --crdb-guid db6365b5-8aca-4055-95d8-7eb0105c0b35 --instance-id 2 --force\nTask b1eba5ba-90de-49e9-8678-d66daa1afb51 created\n  ---> Status changed: queued -> started\n  ---> Status changed: started -> finished",
      "section_id": "example"
    }
  ]
}