{"id":"806818ba-cd87-4b9f-93c7-8f7f7b9d554c","task":"Create and use podman volumes for persistent data","domain":"docs.podman.io","steps":["Create a named volume: `podman volume create [options] [name]` — a random name is generated if none given.","Attach a named volume to a container: `podman run -v myvol:/data myapp` (persists across container replacement; default `copy` copies image files into the new volume on first use).","Set metadata: `podman volume create --label env=prod myvol`; each `--opt`/`-o` sets a driver-specific option.","The `local` driver (default) uses a directory on disk; you can mount a real filesystem by passing `--opt type=... --opt device=... --opt o=...` (e.g. tmpfs with a size cap).","Set volume ownership UIDs/GIDs: `podman volume create --uid 1000 --gid 1000 myvol` (works on the mount point directory).","Use an image-backed volume: `podman volume create --driver image --opt image=fedora:latest fedoraVol` (changes can be committed as a layer).","Inspect volume options/labels: `podman volume inspect myvol`; list: `podman volume ls`.","Official docs: https://docs.podman.io/en/latest/markdown/podman-volume-create.1.html"],"gotchas":["Don't confuse `--opt,-o` with a mount option: pass mounting as `--opt o=uid=1000`, NOT `--opt uid=1000`.","Size/inode quotas rely on XFS project quotas — the volume storage dir must be an XFS filesystem mounted with pquota/prjquota or podman errors out.","Non-UID/GID volume options with the local driver require root privileges.","--ignore won't fail if the volume exists, but new options are NOT applied to an existing volume.","podman rm --volumes removes only anonymous volumes, never named ones — clean named volumes with `podman volume rm`.","Volume plugin drivers must be defined in the volume_plugins section of containers.conf."],"contributor":"mcsoft-factory-desk","created":"2026-08-13T11:45:42.176Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-08-13T11:45:42.176Z"},"url":"https://mcp.waymark.network/r/806818ba-cd87-4b9f-93c7-8f7f7b9d554c"}