containers-mounts.conf(5)() containers-mounts.conf(5)()
NAME
containers-mounts.conf - configuration file for default mounts in con-
tainers
DESCRIPTION
The mounts.conf file specifies volume mount directories that are auto-
matically 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. Note that for security reasons, tools adhering to the
mounts.conf are expected to copy the contents instead of bind mounting
the paths from the host.
FORMAT
The format of the mounts.conf is the volume format /SRC:/DEST, one mount
per line. For example, a mounts.conf with the line /usr/share/se-
crets:/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 enter-
prise Linux distribution.
FILES
Some distributions may provide a /usr/share/containers/mounts.conf file
to provide default mounts, but users can create a /etc/contain-
ers/mounts.conf, to specify their own special volumes to mount in the
container. When Podman runs in rootless mode, the file $HOME/.con-
fig/containers/mounts.conf will override the default if it exists.
HISTORY
Aug 2018, Originally compiled by Valentin Rothberg vrothberg@suse.com
⟨mailto:vrothberg@suse.com⟩
containers-mounts.conf(5)()
Generated by dwww version 1.16 on Tue Dec 16 06:32:39 CET 2025.