1CONTAINERS-REGISTRIES.CONF(5) Aug 2017 CONTAINERS-REGISTRIES.CONF(5)
2
3
4
6 containers-registries.conf - Syntax of System Registry Configuration
7 File
8
9
10
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
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
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
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)