docker/dtr install

Estimated reading time: 3 minutes

These are the docs for DTR version 2.1

To select a different version, use the selector below.

Install Docker Trusted Registry on this Docker Engine

Usage

docker run -it --rm docker/dtr \
    install [command options]

Description

This command installs DTR on the Docker Engine that runs the command. After installing DTR, you can add more nodes to a DTR cluster with the ‘join’ command.

Options

OptionDescription
--ucp-urlSpecify the UCP controller URL including domain and port
--ucp-usernameSpecify the UCP admin username
--ucp-passwordSpecify the UCP admin password
--debugEnable debug mode, provides additional logging
--hub-usernameSpecify the Docker Hub username for pulling images
--hub-passwordSpecify the Docker Hub password for pulling images
--http-proxySet the HTTP proxy for outgoing requests
--https-proxySet the HTTPS proxy for outgoing requests
--no-proxySet the list of domains to not proxy to
--replica-http-portSpecify the public HTTP port for the DTR replica; 0 means unchanged/default
--replica-https-portSpecify the public HTTPS port for the DTR replica; 0 means unchanged/default
--log-protocolThe protocol for sending container logs: tcp, tcp+tls, udp or internal. Default: internal
--log-hostEndpoint to send logs to, required if –log-protocol is tcp or udp
--log-levelLog level for container logs. Default: INFO
--log-tls-ca-certPEM-encoded TLS CA cert for DTR logging driver. This option is ignored if the address protocol is not tcp+tls.
--log-tls-certPEM-encoded TLS cert for DTR logging driver. This option is ignored if the address protocol is not tcp+tls.
--log-tls-keyPEM-encoded TLS key for DTR logging driver. This option is ignored if the address protocol is not tcp+tls.
--log-tls-skip-verifyConfigures DTR logging driver’s TLS verification. This verification is enabled by default, but it can be overrided by setting this option to true. This option is ignored if the address protocol is not tcp+tls.
--dtr-external-urlSpecify the external domain name and port for DTR. If using a load balancer, use its external URL instead.
--enable-pprofEnables pprof profiling of the server
--etcd-heartbeat-intervalSet etcd’s frequency (ms) that its leader will notify followers that it is still the leader.
--etcd-election-timeoutSet etcd’s timeout (ms) for how long a follower node will go without hearing a heartbeat before attempting to become leader itself.
--etcd-snapshot-countSet etcd’s number of changes before creating a snapshot.
--ucp-insecure-tlsDisable TLS verification for UCP
--ucp-caUse a PEM-encoded TLS CA certificate for UCP
--nfs-storage-urlURL (with IP address or hostname) of the NFS mount if using NFS (e.g. nfs:// /)
--ucp-nodeSpecify the host to install Docker Trusted Registry
--replica-idSpecify the replica ID. Must be unique per replica, leave blank for random
--unsafeEnable this flag to skip safety checks when installing or joining
--extra-envsList of extra environment variables to use for deploying the DTR containers for the replica. This can be used to specify swarm constraints. Separate the environment variables with ampersands (&). You can escape actual ampersands with backslashes (). Can’t be used in combination with –ucp-node
docker, dtr, cli, install