podman-image-mount(1) General Commands Manual podman-image-mount(1)
NAME
podman-image-mount - Mount an image's root filesystem
SYNOPSIS
podman image mount [options] [image ...]
DESCRIPTION
Mounts the specified images' root file system in a location which can be
accessed from the host, and returns its location.
The podman image mount command without any arguments lists all of the
currently mounted images.
Rootless mode only supports mounting VFS driver, unless podman is run in
a user namespace. Use the podman unshare command to enter the user
namespace. All other storage drivers fail to mount.
RETURN VALUE
The location of the mounted file system. On error an empty string and
errno is returned.
OPTIONS
--all, -a
Mount all images.
--format=format
Print the mounted images in specified format (json).
EXAMPLE
Mount multiple images. Note: In rootless mode, image mounting works only
after executing 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)
podman-image-mount(1)
Generated by dwww version 1.16 on Tue Dec 16 06:20:29 CET 2025.