> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kubox.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# kubox cluster delete

Ask the plane to destroy a cluster it manages

### Synopsis

Asks the plane to tear the cluster down, and watches its record until it
is gone, the plane says why it cannot be, or --wait runs out.

The plane answers 202: ACCEPTED, not done. The operator destroys the
infrastructure behind a finalizer and the record outlives this command
until that succeeds. "Deleted" is said only when the record has gone;
a teardown still running is reported as in progress; and a teardown the
operator has given up on -- most often because the customer withdrew the
trust Kubox builds with -- is reported as blocked, with whose action it is.

What survives: the CloudAccount, its bucket, its keys, every other cluster.
A delete reaches one prefix of one bucket and no further. `--plan` says so.

Requires --yes.

```
kubox cluster delete <name> [flags]
```

### Options

```
  -h, --help            help for delete
      --plan            say what would be deleted and preserved, and do nothing
      --wait duration   how long to watch the record after the plane accepts (default: long enough to catch an immediate refusal, not a whole teardown)
      --yes             perform the delete; without this it is refused
```

### Global options

See [global options](/cli-reference/kubox#global-options).

### SEE ALSO

* [kubox cluster](/cli-reference/kubox_cluster)	 - Work with clusters a management plane manages