.nh
.TH podman-image-mount 1
.SH NAME
.PP
podman-image-mount - Mount an image's root filesystem

.SH SYNOPSIS
.PP
\fBpodman image mount\fP [\fIoptions\fP] [\fIimage\fP ...]

.SH DESCRIPTION
.PP
Mounts the specified images' root file system in a location which can be
accessed from the host, and returns its location.

.PP
The \fBpodman image mount\fR command without any arguments lists all of the
currently mounted images.

.PP
Rootless mode only supports mounting VFS driver, unless podman is run in a user namespace.
Use the \fBpodman unshare\fR command to enter the user namespace. All other storage drivers fail to mount.

.SH RETURN VALUE
.PP
The location of the mounted file system.  On error an empty string and errno is
returned.

.SH OPTIONS
.SS \fB--all\fP, \fB-a\fP
.PP
Mount all images.

.SS \fB--format\fP=\fIformat\fP
.PP
Print the mounted images in specified format (json).

.SH EXAMPLE
.EX
podman image mount fedora ubi8-init

/var/lib/containers/storage/overlay/f3ac502d97b5681989dff84dfedc8354239bcecbdc2692f9a639f4e080a02364/merged
/var/lib/containers/storage/overlay/0ff7d7ca68bed1ace424f9df154d2dd7b5a125c19d887f17653cbcd5b6e30ba1/merged
.EE

.EX
podman 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
.EE

.EX
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"
 }
]
.EE

.SH SEE ALSO
.PP
\fBpodman(1)\fP, \fBpodman-image(1)\fP, \fBpodman-image-unmount(1)\fP, \fBpodman-unshare(1)\fP, \fBmount(8)\fP