docker/dtr join

Estimated reading time: 1 minute

Add a new replica to an existing DTR cluster


This command creates a replica of an existing DTR on a node managed by Docker Universal Control Plane (UCP).

For setting DTR for high-availability, create 3, 5, or 7 replicas of DTR.


Option Description
--debug Enable debug mode for additional logging
--existing-replica-id The ID of an existing DTR replica
--extra-envs Environment variables or swarm constraints for DTR containers. Format var=val[&var=val]
--hub-password Password to use when pulling images
--hub-username Username to use when pulling images
--replica-http-port The public HTTP port for the DTR replica. Default is 80
--replica-https-port The public HTTPS port for the DTR replica. Default is 443
--replica-id Assign an ID to the DTR replica. By default the ID is random
--skip-network-test Don’t test if overlay networks are working correctly between UCP nodes
--ucp-ca Use a PEM-encoded TLS CA certificate for UCP
--ucp-insecure-tls Disable TLS verification for UCP
--ucp-node The hostname of the target UCP node. Set to empty string or “random” to pick one at random.
--ucp-password The UCP administrator password
--ucp-url The UCP URL including domain and port
--ucp-username The UCP administrator username
--unsafe Allow DTR to be installed on any engine version
--unsafe-join Perform the join despite the cluster containing unhealthy replicas.
chat icon Feedback? Suggestions? Can't find something in the docs?
Edit this page Request docs changes Get support
Rate this page: