bae5f5
% registries.conf(5) System-wide registry configuration file
bae5f5
% Brent Baude
bae5f5
% Aug 2017
bae5f5
bae5f5
# NAME
bae5f5
registries.conf - Syntax of System Registry Configuration File
bae5f5
bae5f5
# DESCRIPTION
bae5f5
The REGISTRIES configuration file is a system-wide configuration file for container image
bae5f5
registries. The file format is TOML.
bae5f5
bae5f5
# FORMAT
bae5f5
The TOML_format is used to build simple list format for registries under two
bae5f5
categories: `search` and `insecure`. You can list multiple registries using
bae5f5
as a comma separated list.
bae5f5
bae5f5
Search registries are used when the caller of a container runtime does not fully specify the
bae5f5
container image that they want to execute.  These registries are prepended onto the front
bae5f5
 of the specified container image until the named image is found at a registry.
bae5f5
bae5f5
Insecure Registries.  By default container runtimes use TLS when retrieving images
bae5f5
from a registry.  If the registry is not setup with TLS, then the container runtime
bae5f5
will fail to pull images from the registry. If you add the registry to the list of
bae5f5
insecure registries then the container runtime will attempt use standard web protocols to
bae5f5
pull the image.  It also allows you to pull from a registry with self-signed certificates.
bae5f5
Note insecure registries can be used for any registry, not just the
bae5f5
registries listed under search.
bae5f5
bae5f5
The following example configuration defines two searchable registries and one
bae5f5
insecure registry.
bae5f5
bae5f5
```
bae5f5
[registries.search]
bae5f5
registries = ["registry1.com", "registry2.com"]
bae5f5
bae5f5
[registries.insecure]
bae5f5
registries = ["registry3.com"]
bae5f5
```
bae5f5
bae5f5
# HISTORY
bae5f5
Aug 2017, Originally compiled by Brent Baude <bbaude@redhat.com>