podman-image-mount(1)

💅 NAME 💅

podman-image-mount — bestie, it mounts an image's root filesystem. That's the whole job. 🫶

---

✨ SYNOPSIS ✨

podman image mount [options] [image ...]

---

🎀 DESCRIPTION 🎀

Okay so here's the tea: podman image mount takes the images you name and mounts their root file system somewhere the host can actually reach it, then hands you back that location like a little gift. 🎁

Run podman image mount with zero arguments and it just lists every image that's currently mounted. A whole vibe check of your mounts, if you will. 👑

⚠️ rootless girlies, listen up ⚠️ Rootless mode only supports mounting the VFS driver — unless podman is running inside a user namespace. Use the podman unshare command to hop into that user namespace. Every other storage driver fails to mount, no cap, it's not happening. 😭

---

🌈 RETURN VALUE 🌈

It gives you the location of the mounted file system. And if something goes wrong? You get an empty string plus errno. That's it. That's the message. 💀

---

🌸 OPTIONS 🌸

• --all, -a — Mount all the images. Every single one. Greedy (affectionate). ✨
• --format=format — Print the mounted images in the format you specify (currently that means json). Fancy output for fancy people. 💅

---

🦋 EXAMPLES 🦋

Mount multiple images. Note: in rootless mode, image mounting works only after running the podman unshare command to enter the user namespace. 🧚

podman image mount fedora ubi8-init
/var/lib/containers/storage/overlay/f3ac502d97b5681989dff84dfedc8354239bcecbdc2692f9a639f4e080a02364/merged
/var/lib/containers/storage/overlay/0ff7d7ca68bed1ace424f9df154d2dd7b5a125c19d887f17653cbcd5b6e30ba1/merged

List mounted images:

podman image mount
registry.fedoraproject.org/fedora:latest /var/lib/containers/storage/overlay/f3ac502d97b5681989dff84dfedc8354239bcecbdc2692f9a639f4e080a02364/merged
registry.access.redhat.com/ubi8-init:latest /var/lib/containers/storage/overlay/0ff7d7ca68bed1ace424f9df154d2dd7b5a125c19d887f17653cbcd5b6e30ba1/merged

List mounted images in JSON format:

podman image mount --format json
[
 {
  "id": "00ff39a8bf19f810a7e641f7eb3ddc47635913a19c4996debd91fafb6b379069",
  "Names": [
   "sha256:58de585a231aca14a511347bc85b912a6f000159b49bc2b0582032911e5d3a6c"
  ],
  "Repositories": [
   "registry.fedoraproject.org/fedora:latest"
  ],
  "mountpoint": "/var/lib/containers/storage/overlay/0ccfac04663bbe8813b5f24502ee0b7371ce5bf3c5adeb12e4258d191c2cf7bc/merged"
 },
 {
  "id": "bcc2dc9a261774ad25a15e07bb515f9b77424266abf2a1252ec7bcfed1dd0ac2",
  "Names": [
   "sha256:d5f260b2e51b3ee9d05de1c31d261efc9af28e7d2d47cedf054c496d71424d63"
  ],
  "Repositories": [
   "registry.access.redhat.com/ubi8-init:latest"
  ],
  "mountpoint": "/var/lib/containers/storage/overlay/d66b58e3391ea8ce4c81316c72e22b332618f2a28b461a32ed673e8998cdaeb8/merged"
 }
]

---

👑 SEE ALSO 👑

podman(1), podman-image(1), podman-image-unmount(1), podman-unshare(1), mount(8)

---

and that's the whole page, bestie!! 🫶 this lil cutie lives in the General Commands Manual as podman-image-mount(1) — go forth and mount responsibly 💖✨