1CONTAINERS-REGISTRIES.CONF(5)      Aug 2017      CONTAINERS-REGISTRIES.CONF(5)
2
3
4

NAME

6       containers-registries.conf - Syntax of System Registry Configuration
7       File
8
9
10

DESCRIPTION

12       The CONTAINERS-REGISTRIES configuration file is a system-wide
13       configuration file for container image registries. The file format is
14       TOML. The valid categories are: 'registries.search',
15       'registries.insecure', and
16
17
18       By default, the configuration file is located at
19       /etc/containers/registries.conf.
20
21
22

FORMAT

24       The TOML_format is used to build a simple list format for registries
25       under three categories: registries.search, registries.insecure, and
26       registries.block.  You can list multiple registries using a comma
27       separated list.
28
29
30       Search registries are used when the caller of a container runtime does
31       not fully specify the container image that they want to execute.  These
32       registries are prepended onto the front of the specified container
33       image until the named image is found at a registry.
34
35
36       Insecure Registries.  By default container runtimes use TLS when
37       retrieving images from a registry.  If the registry is not setup with
38       TLS, then the container runtime will fail to pull images from the
39       registry. If you add the registry to the list of insecure registries
40       then the container runtime will attempt use standard web protocols to
41       pull the image.  It also allows you to pull from a registry with
42       self-signed certificates.  Note insecure registries can be used for any
43       registry, not just the registries listed under search.
44
45
46       Block Registries.  The registries in this category are are not pulled
47       from when retrieving images.
48
49
50

EXAMPLE

52       The following example configuration defines two searchable registries,
53       one insecure registry, and two blocked registries.
54
55
56              [registries.search]
57              registries = ['registry1.com', 'registry2.com']
58
59              [registries.insecure]
60              registries = ['registry3.com']
61
62              [registries.block]
63              registries = ['registry.untrusted.com', 'registry.unsafe.com']
64
65
66
67

HISTORY

69       Aug 2018, Renamed to containers-registries.conf(5) by Valentin Rothberg
70       ⟨vrothberg@suse.com⟩
71
72
73       Jun 2018, Updated by Tom Sweeney ⟨tsweeney@redhat.com⟩
74
75
76       Aug 2017, Originally compiled by Brent Baude ⟨bbaude@redhat.com⟩
77
78
79
80Brent Baude         System-wide registry configuraCtOiNoTnAIfNiElReS-REGISTRIES.CONF(5)
Impressum