Deploy DDC on Linux servers

Estimated reading time: 3 minutes

The best way to try Docker Datacenter for yourself is to get the 30-day trial available at the Docker Store.

Once you get your trial license, you can install Docker Datacenter in your Linux servers. Make sure all the hosts you want to manage in with Docker Datacenter have a minimum of:

  • Linux kernel version 3.10 or higher
  • CS Docker Engine version 1.12.1 or higher
  • 2.00 GB of RAM
  • 3.00 GB of available disk space

Also make sure the hosts are running one of these operating systems:

  • CentOS 7.1 or 7.2
  • Red Hat Enterprise Linux 7.0, 7.1, or 7.2
  • Ubuntu 14.04 LTS
  • SUSE Linux Enterprise 12

Learn more about the Docker Datacenter system requirements

Step 2: Install CS Docker Engine

Install the commercially supported Docker Engine on all hosts you want to manage with Docker Datacenter.

Log in into each host using ssh, and install CS Docker Engine:

curl -SLf https://packages.docker.com/1.12/install.sh | sh

You can also install CS Docker Engine using a package manager

Step 3: Install Universal Control Plane

Docker Universal Control Plane (UCP) allows managing from a centralized place your images, applications, networks, and other computing resources.

Use ssh to log in into the host where you want to install UCP and run:

docker run --rm -it --name ucp \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker/ucp install \
  --host-address <node-ip-address> \
  --interactive

This runs the install command in interactive mode, so that you’re prompted for any necessary configuration values.

Learn more about the UCP installation

Step 4: License your installation

Now that UCP is installed, you need to license it. In your browser, navigate to the UCP web UI, login with your administrator credentials and upload your license.

Get a free trial license if you don’t have one.

Step 5: Join more nodes to UCP

Join more nodes so that you can manage them from UCP. Go to the UCP web UI, navigate to the Resources page, and go to the Nodes section.

Click the Add Node button to add a new node.

Check the ‘Add node as a manager’ option to join the node as a manager to provide replication and make UCP highly available. For a highly available installation, make sure you have 3, 5, or 7 manager nodes.

Copy the command to your clipboard, and run in on every node that you want to be managed by UCP. After you run the command in the node, the node will show up in the UP web UI.

Step 6: Install Docker Trusted Registry

Docker Trusted Registry (DTR) is a private image registry so that you can manage who has access to your Docker images. DTR needs to be installed on a node that is being managed by UCP.

Use ssh to log in into the host where you already installed UCP, and run:

docker run -it --rm \
  docker/dtr install \
  --ucp-node <node-hostname> \
  --ucp-insecure-tls

Where the --ucp-node is the hostname of the UCP node where you want to deploy DTR. --ucp-insecure-tls tells the installer to trust the certificates used by UCP.

Where to go next

chat icon Feedback? Suggestions? Can't find something in the docs?
Edit this page Request docs changes Get support
Rate this page: