helix prune

​

Usage

helix prune [INSTANCE] [OPTIONS]

​

Arguments

​

Options

​

Behavior

• The container named helix-<project>-<instance>.
• The disk-mode SeaweedFS sidecar, network, and persistent volume when present, plus any MinIO sidecar and volume left by an older CLI.
• The disk-cache volume of a disk-mode or S3 instance.
• The per-instance directory under .helix/.

• helix prune <instance> removes resources without confirmation, including persisted disk-mode data.
• helix prune --all prints a warning and asks for confirmation in a TTY. Without a TTY, or with --json, it refuses to run without --yes:
  refusing to prune every local instance without confirmation
  
• If nothing was found to prune for an instance, the CLI prints No local runtime resources found for <instance> and exits successfully.
• With --json, prints one object for the whole run: {"pruned":[{"instance":"dev","removed":true}]}.

​

Examples

# Prune a specific instance
helix prune dev

# Interactive selection (TTY)
helix prune

# Prune everything Helix-owned for every local instance
helix prune --all

# Same, non-interactively
helix prune --all --yes

​

Related

• helix stop — stop an instance but keep disk-mode data.
• helix delete — also remove the instance from helix.toml.
• helix start — start a fresh instance after pruning.