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
admin migrate-images— repoint old disks before updating a tier- Images & tiers — disk use and immutable bases