3d4e4fd
% CONTAINERS-REGISTRIES.CONF.D(5)
3d4e4fd
% Valentin Rothberg
3d4e4fd
% Mar 2020
3d4e4fd
3d4e4fd
# NAME
3d4e4fd
containers-registries.conf.d - directory for drop-in registries.conf files
3d4e4fd
3d4e4fd
# DESCRIPTION
3d4e4fd
CONTAINERS-REGISTRIES.CONF.D is a system-wide directory for drop-in
3d4e4fd
configuration files in the `containers-registries.conf(5)` format.
3d4e4fd
3d4e4fd
By default, the directory is located at `/etc/containers/registries.conf.d`.
3d4e4fd
3d4e4fd
# CONFIGURATION PRECEDENCE
3d4e4fd
3d4e4fd
Once the main configuration at `/etc/containers/registries.conf` is loaded, the
3d4e4fd
files in `/etc/containers/registries.conf.d` are loaded in alpha-numerical
b115503
order. Then the conf files in `$HOME/.config/containers/registries.conf.d` are loaded in alpha-numerical order, if they exist. If the `$HOME/.config/containers/registries.conf` is loaded, only the conf files under `$HOME/.config/containers/registries.conf.d` are loaded in alpha-numerical order.
b115503
Specified fields in a conf file will overwrite any previous setting.  Note
3d4e4fd
that only files with the `.conf` prefix are loaded, other files and
3d4e4fd
sub-directories are ignored.
3d4e4fd
3d4e4fd
For instance, setting the `unqualified-search-registries` in
3d4e4fd
`/etc/containers/registries.conf.d/myregistries.conf` will overwrite previous
3d4e4fd
settings in `/etc/containers/registries.conf`.  The `[[registry]]` tables merged
3d4e4fd
by overwriting existing items if the prefixes are identical while new ones are
3d4e4fd
added.
3d4e4fd
3d4e4fd
All drop-in configuration files must be specified in the version 2 of the
3d4e4fd
`containers-registries.conf(5)` format.
3d4e4fd
3d4e4fd
# SEE ALSO
3d4e4fd
`containers-registries.conf(5)`
3d4e4fd
3d4e4fd
# HISTORY
3d4e4fd
3d4e4fd
Mar 2020, Originally compiled by Valentin Rothberg <rothberg@redhat.com>