skopeo/registries.conf.5.md

40 lines
1.5 KiB
Markdown
Raw Normal View History

% registries.conf(5) Container Registries Configuration File
% Dan Walsh
% March 2018
## NAME
registries.conf - Syntax of Container Registries configuration file
## DESCRIPTION
The REGISTRIES configuration file specifies all of the available container registries for tools using shared container registries, but in a TOML format that can be more easily modified and versioned. `registries.conf` does not support recursive lists of registries. The default location for this configuration file is `/etc/containers/registries.conf`.
The only valid categories are: `registries.search`, `registries.insecure`, and `registries.block`.
## FORMAT
The [TOML format][toml] is used as the encoding of the configuration file.
Every option and subtable listed here is nested under a global "registries" table.
No bare options are used.
## Examples
[registries.search]
registries = ['quay.io', 'docker.io', 'registries.unsafe.com', 'registry.fedoraproject.org', 'registry.access.redhat.com']
# If you need to access insecure registries, add the registry's fully-qualified name.
# An insecure registry is one that does not have a valid SSL certificate or only does HTTP.
[registries.insecure]
registries = ['registries.unsafe.com']
# If you need to block push access from a registry, uncomment the section below
# and add the registries fully-qualified name.
#
# Docker only
[registries.block]
registries = []
## Files
/etc/conainers/registries.conf
## HISTORY
March 2018, Originally compiled by Dan Walsh <dwalsh@redhat.com>