podman-volume-ls(1)

📦
version 6.1.4 · 20 versions
, in arch rolling

podman-volume-ls — the glow-up guide 💅✨

okay so bestie, listen — you want to see every single volume chillin' on your system? this is literally the command for that. it's podman-volume-ls, and it's giving "let me show you what's in my closet" but for storage. no cap, it's iconic.

NAME 🎀

podman-volume-ls — list all the available volumes, periodt.

SYNOPSIS ✨

podman volume ls [options]

DESCRIPTION 🌸

so this command lists all the volumes that exist on your system. that's it, that's the vibe. 💖

but here's where it gets cute — you can:

  • filter the output with the --filter flag (iykyk, we'll get to that)
  • format it as either JSON or a Go template using the --format flag
  • use the --quiet flag to print only the volume names (for when you're lowkey in a rush)

it's flexible, it's powerful, it's main character energy fr fr. 🦋

OPTIONS 👑

--filter, -f=filter 🔍

okay so this one filters what volumes are shown in the output. super useful when you have like a million volumes and you only care about a few.

important rule: if you have more than one filter, you gotta pass the --filter option multiple times — like this:

--filter name=test --filter driver=local

now let's talk filter logic because it's giving ✨nuance✨:

  • filters with the same key work inclusive — the only exception is label, which is exclusive
  • filters with different keys always work exclusive

volumes can be filtered by these attributes, bestie:

  • anonymous — [Bool] matches anonymous volumes (true) or named volumes (false)
  • dangling — [Dangling] matches all volumes not referenced by any containers
  • driver — [Driver] matches volumes based on their driver
  • label — [Key] or [Key=Value] label assigned to a volume
  • label! — [Key] or [Key=Value] volumes without the specified label
  • name — [Name] volume name (accepts regex!)
  • opt — matches a storage driver options
  • scope — filters volume by scope
  • after/since — filter by volumes created after the given VOLUME (name or tag)
  • until — filter by volumes created before given timestamp

--format=format 🎨

this beautifies your volume output using a Go template. valid placeholders for the Go template are listed below — no gatekeeping here:

  • .Anonymous — indicates whether volume is anonymous
  • .CreatedAt ... — volume creation time
  • .Driver — volume driver
  • .GID — GID of volume
  • .InspectVolumeData ... — don't use 💀
  • .Labels ... — label information associated with the volume
  • .LockNumber — number of the volume's Libpod lock
  • .MountCount — number of times the volume is mounted
  • .Mountpoint — source of volume mount point
  • .Name — volume name
  • .NeedsChown — indicates whether volume needs to be chowned
  • .NeedsCopyUp — indicates if volume needs to be copied up to
  • .Options ... — volume options
  • .Scope — volume scope
  • .Status ... — status of the volume
  • .StorageID — StorageID of the volume
  • .Timeout — timeout of the volume
  • .UID — UID of volume
  • .VolumeConfigResponse ... — don't use 💀

--help 🙋‍♀️

prints the usage statement. simple, slay.

--noheading, -n 📋

omits the table headings from the listing. for when you're feeling minimalistic, periodt.

--quiet, -q 🤫

prints volume output in quiet mode — only the volume names. no labels, no drivers, no extras. just vibes.

EXAMPLES 🌈

list all volumes — the classic:

$ podman volume ls

list all volumes and display content as json format — for the data girlies:

$ podman volume ls --format json

list all volumes and display their Driver and Scope fields — a little curated moment:

$ podman volume ls --format "{{.Driver}} {{.Scope}}"

list volumes with the name foo and label blue — specific and cute:

$ podman volume ls --filter name=foo,label=blue

list volumes with the label key=value — iykyk:

$ podman volume ls --filter label=key=value

SEE ALSO 👀

HISTORY 📜

November 2018 — originally compiled by Urvashi Mohnani (umohnani@redhat.com ⟨mailto:umohnani@redhat.com⟩). a true icon, we stan. 💖

okay bestie, that's the whole page — from the podman-volume-ls(1) header all the way down to the podman-volume-ls(1) footer, which means this manual page is from general commands land and was compiled back in November 2018 by Urvashi Mohnani. slayed. 💅✨🫶

📦 where this page comes from