Skip to content

1ctl nats delete

Delete a NATS deployment

1ctl nats delete <deployment-name-or-id>

destroy, rm

Argument Required Variadic
deployment-name-or-id Yes No
Flag Type Required Default Description
--yes, -y boolean No false Skip confirmation
--purge-retained boolean No false Also purge retained persistent volumes
--no-wait boolean No false Return after deletion is accepted
--help, -h boolean No — Show help
Terminal window
1ctl nats delete events-ha --yes

Persistent volumes are retained by default and may continue to incur storage charges. This default protects JetStream data from an accidental workload deletion.

Terminal window
1ctl nats delete events-ha --purge-retained --yes

--purge-retained permanently removes retained persistent volumes. Confirm that required stream data has been exported and no clients depend on the deployment before using it.

By default the CLI waits up to five minutes for deletion to finish. Use --no-wait only when another process will monitor the operation.