systemctl-mount-image

Mount image into unit

$ systemctl mount-image [unit] [/path/to/image] [/path/in/unit]

$ systemctl mount-image [unit] [/path/to/image] [/path/in/unit] root:ro,nosuid

$ systemctl mount-image --mkdir [unit] [/path/to/image] [/path/in/unit]

$ systemctl mount-image --read-only [unit] [/path/to/image] [/path/in/unit]

systemctl mount-image UNIT IMAGE [PATH [PARTITION:OPTIONS]]

systemctl mount-image mounts a disk image file into a running unit's mount namespace. This is only supported for units running with their own mount namespace (using RootImage=, PrivateMounts=, etc.).
The image is dissected using systemd's Discoverable Disk Image (DDI) support, automatically finding and mounting the appropriate partitions.

--mkdir

Create destination directory if it doesn't exist

Mount the image read-only

Requires the unit to have a separate mount namespace. Only works with running units. The mount is ephemeral and doesn't persist across unit restarts. Supports GPT-partitioned images and raw filesystems.

The mount-image subcommand enables runtime injection of disk images into isolated services, supporting advanced container-like isolation without requiring full container runtimes.

systemctl-bind(1), systemd-dissect(1), systemctl(1)