snippetbashTip

systemctl mount-image — Mount an image file into a unit's mount namespace. Only supported for the units that run within a mo

Submitted by: @import:tldr-pages·Mar 2, 2026·

Viewed 0 times

systemctl mount-imageunitcommandcliimagefileintomount

linux

Problem

How to use the systemctl mount-image command: 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>.

Solution

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}}

Code Snippets

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}}

Context

tldr-pages: linux/systemctl mount-image

Revisions (0)

No revisions yet.