---
syntax: markdown
tags: [tldr, linux]
source: https://github.com/tldr-pages/tldr.git
---
# systemctl mount-image

> Mount an image file into a unit's mount namespace.
> Only supported for the units that run within a mountspace ie, with `RootImage=`, `PrivateMounts=`, etc.
> More information: <https://www.freedesktop.org/software/systemd/man/latest/systemctl.html#mount-image%20UNIT%20IMAGE%20%5BPATH%20%5BPARTITION_NAME:MOUNT_OPTIONS%5D%5D>.

- Mount an image at a specific path inside the unit's mount namespace:

`systemctl mount-image {{unit}} /{{path/to/image}} /{{path/to/directory_inside_unit}}`

- Mount the image's `root` partition with read-only and no-setuid options:

`systemctl mount-image {{unit}} /{{path/to/image}} /{{path/to/directory_inside_unit}} root:ro,nosuid`

- Create the destination directory before mounting:

`systemctl mount-image --mkdir {{unit}} /{{path/to/image}} /{{path/to/directory_inside_unit}}`

- Mount an image as read-only:

`systemctl mount-image --read-only {{unit}} /{{path/to/image}} /{{path/to/directory_inside_unit}}`