Uninstallation

Remove the boks binary

rm ~/.local/bin/boks

Remove shims

Shims are symlinks in ~/.local/bin that point to the boks binary. List them first:

boks --list

Remove each shim:

rm ~/.local/bin/<tool-name>

Remove cached data

boks keeps state in three places: configuration in ~/.config/boks/, regenerable caches (tool index, scan verdicts, the grype database) in ~/.cache/boks/, and your security decisions (accepted scans, trusted projects) in ~/.local/share/boks/.

To reclaim disk without uninstalling, use the built-in command — it knows what is safe to remove and what is not:

boks --status         # what is on disk, by category
boks --clean cache    # drop every regenerable cache

To remove everything, including your security decisions:

rm -rf ~/.config/boks/ ~/.cache/boks/ ~/.local/share/boks/

Remove cached container images

Cached container images are managed by your container runtime, not by boks. To free that space:

# Remove all images pulled by boks (environment images)
boks --clean

# Remove all images from Podman entirely (affects other uses too)
podman rmi --all

Remove the PATH entry

Remove the ~/.local/bin export from your ~/.bashrc or ~/.zshrc if you added it for boks and no longer need it.