podman-image-mount(1) General Commands Manual podman-image-mount(1)

# [NAME](#NAME)

podman-image-mount - Mount an image's root filesystem

# [SYNOPSIS](#SYNOPSIS)

**podman image mount** \[*options*] \[*image* ...]

# [DESCRIPTION](#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](#RETURN_VALUE)

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

# [OPTIONS](#OPTIONS)

## **--all**, **-a**

Mount all images.

## **--format**=*format*

Print the mounted images in specified format (json).

# [EXAMPLES](#EXAMPLES)

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](#SEE_ALSO)

[**podman(1)**](/man/enterprise-packages/podman-doc-6.0/podman.1), [**podman-image(1)**](/man/enterprise-packages/podman-doc-6.0/podman-image.1), [**podman-image-unmount(1)**](/man/enterprise-packages/podman-doc-6.0/podman-image-unmount.1), [**podman-unshare(1)**](/man/enterprise-packages/podman-doc-6.0/podman-unshare.1), [**mount(8)**](/man/enterprise-packages/podman-doc-6.0/mount.8)

---

Document: podman-image-mount(1) from podman-doc-6.0 6.0.2-r14 (Chainguard OS)
Source: https://github.com/containers/podman