Skip to content

bhatti admin gc-images

bhatti admin gc-images server only

Remove unreferenced immutable base images from the local server.

Synopsis

sudo bhatti admin gc-images [--dry-run]

Description

Scans <data_dir>/images/bases/ and preserves bases referenced by a tier image, sandbox, snapshot, saved image or configured krucible_base_image. Unused bases are removed. The daemon also runs collection on startup; this command lets you inspect or perform it manually. It uses the local data directory and loads server configuration — it is not a remote API request. An older tier base stays on disk as long as any dependent disk still uses it.

Examples

sudo bhatti admin gc-images --dry-run   # show what would be removed
sudo bhatti admin gc-images             # remove unused bases

If nothing qualifies, the command reports no unused base images.

Options

| Flag | Default | Description | | --- | --- | --- | | --dry-run | false | List candidates without deleting them. |

Global --data-dir selects the data directory; the loaded server configuration still determines which krucible_base_image must be kept. --json returns removed and dry_run fields. See Global flags.

See also