Docker Server Configuration

From NovaOrdis Knowledge Base
Revision as of 20:51, 2 October 2018 by Ovidiu (talk | contribs) (→‎--add-registry)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search




Server Startup Sequence

RedHat/Centos systemd

systemd Docker Unit File: /usr/lib/systemd/system/docker.service. Depending on the distribution, the unit file may or may not refer configuration from /etc/sysconfig/docker.

Server Startup Configuration

daemon.json also contains server configuration and it is an alternative to configuration specified as command line parameters and in various startup configuration files read when the server is started.

OS-Dependent Startup Configuration Files Details


Daemon configuration parameters are usually provided in /etc/sysconfig/docker. However, the availability of this file may depend on distribution and installation procedure.


The simples possible way to configure the Docker daemon on Mac is to use the UI: the whale icon-> Preferences -> Daemon.

The "Basic" section has UI elements to configure insecure registries and registry mirrors. A configuration change applied here propagates to the "Advanced" section after daemon restart.

The "Advanced" section gives access to the content of daemon.json file, which can be edited freely. However, the danger is that a configuration error saved here will prevent the daemon to start. If that happens, the file-system version of the same file can be accessed as follows:

cd ~/Library/Containers/com.docker.docker/Data/database 
git reset --hard HEAD

The daemon.json becomes available as:


The file can be edited and committed, and the daemon restart.

Server Configuration Options

The following options are Docker server command line options and should be provided on the dockerd daemon command line, when started.


This option instructs the Docker daemon to trust any Docker registry on the indicated subnet, rather than requiring a certificate. The default value is []. For OpenShift-integrated Docker, the subnet where Docker expects this registry is the OpenShift SDN services subnet.

... --insecure-registry <list> ...

The same option can be configured in daemon.json with insecure-registries.


Not found in Docker 18.03-ce. Also see Docker Networking Concepts.



When asked to search for or pull images, the docker runtime uses the Docker registry ( to complete those activities. Additional registries can be added to the list with --add-registry.

Also see:

Docker Image Registry


To prevent users from pulling images from the Docker registry, after presumably other registry has been configured with --add-registry, use






Docker Container Configuration

Docker Container Configuration