CONTAINERS-MOUNTS.CONF(5)

📦
version 6.0 · 4 versions
, in centos-stream 10, debian trixie, ubuntu noble, ubuntu questing

💅 containers-mounts.conf(5) — default mounts, but make it cute 💅

okay so bestie, welcome to the manual page for containers-mounts.conf — yes, that's containers-mounts.conf(5) in manpage-speak — and it's all about the default mounts that show up inside containers. no cap. 🦋

🌸 NAME 🌸

containers-mounts.conf — configuration file for default mounts in containers. That's it, that's the name, and it ate. ✨

💖 DESCRIPTION 💖

The mounts.conf file specifies volume mount directories that are automatically mounted inside containers. Container processes can then use this content. Usually these directories are used for passing secrets or credentials required by the package software to access remote package repositories. Very "pass the aux but for secrets" energy. 🔥

Security moment, bestie: for security reasons, tools adhering to mounts.conf are expected to copy the contents instead of bind mounting the paths from the host. That's a big deal — copy, don't bind-mount the host paths. 🫶

🎀 FORMAT 🎀

The format of mounts.conf is the volume format /SRC:/DEST, one mount per line. Literally one mount per line, okay? 💅

For example, a mounts.conf with the line

/usr/share/secrets:/run/secrets

would cause the contents of the /usr/share/secrets directory on the host to be mounted on the /run/secrets directory inside the container. Setting mountpoints allows containers to use the files of the host — for instance, to use the host's subscription to some enterprise Linux distribution. iconic behavior, honestly. 🌟

🫶 FILES 🫶

Some distributions may provide a /usr/share/containers/mounts.conf file to provide default mounts, but users can create a /etc/containers/mounts.conf to specify their own special volumes to mount in the container.

When Podman runs in rootless mode, the file $HOME/.config/containers/mounts.conf will override the default if it exists. slay, rootless Podman doing its thing. 🐚

🌈 HISTORY 🌈

Aug 2018, originally compiled by Valentin Rothberg vrothberg@suse.com ⟨mailto:vrothberg@suse.com⟩. 💜

okay that's the whole page! source/version: containers-mounts.conf(5)() and date: blank in the footer — so here's your cute sign-off, bestie. mwah. 💋✨

📦 where this page comes from