Skip to content
OpenCharly

volume

Recipe card from the charly-pod-verbs plugin (Commands — runtime CLI verbs).

charly volume — named-volume inspection and reset

Section titled “charly volume — named-volume inspection and reset”

charly volume manages a deployment’s charly-managed named volumes (app + sidecar alike). It is served by candy/plugin-pod (a command:volume plugin) and is the charly-native replacement for ad-hoc podman volume ls/inspect/rm.

Command tree

Section titled “Command tree”
  • charly volume list <box> [-i <instance>] — list the deployment’s named volumes with their host mountpoints.
  • charly volume reset <box> <name> [-i <instance>] — remove ONE named volume so the next charly start recreates it fresh. <name> is bare (e.g. tailscale-state) or the full charly-<box>-<name> form.

When to use it

Section titled “When to use it”

Reset a volume to force re-initialization — a sidecar’s state volume to force re-auth, or a corrupted cache. The engine refuses an in-use volume, so a running deployment surfaces an actionable error instead of silent data loss; stop the deployment first (charly stop <box>).

Cross-References

Section titled “Cross-References”