Alex Mavrogiannis

Kick the Tires on Docker Datacenter with DDC-In-A-Box!

Alex Mavrogiannis

Docker Datacenter (DDC) is a powerful solution for managing your containerized applications in a production environment. But what if you could kick the tires of DDC on your laptop with just a single script command? Welcome to DDC-In-A-Box!

DDC-In-A-Box is an evaluation script that I wrote which creates a single virtual machine containing Docker Engine, Universal Control Plane (UCP) and Docker Trusted Registry (DTR). The products are licensed using your own license and integrated with each other so you can test out the push/pull integration between UCP and DTR.


DDC-In-A-Box Script

DDC requires that you have Docker Machine (or Docker Toolbox 1.10) already installed on your computer, as it makes use of these tools to create a VM for you to play with. In a Mac or Linux environment that’s all you need; for Windows you will also need a way to execute bash shell scripts, such as CygWin or GitBash.

Once you have these tools, using DDC-In-A-Box is simple:

  1. Sign up for a Docker Datacenter trial and download a trial license key to a folder on your computer. It should look something like “docker_subscription.lic”. If you already have a license key you can use that instead.
  2. Now you need to download and run the shell script. There are two ways to do this:
      • Using bash, navigate to the folder where your license key is located. Once there, use the following curl command to download and execute the script:

    curl -L | bash

    • Alternatively, you may download the script from and place it in the same folder as your trial license key. Then, run the shell script on your computer (on a Mac, use Terminal, navigate to the folder with the script and license key, and type “sh”)
  3. The script will now install and preconfigure DDC in a VM called “ddc-eval” on your laptop. This takes ~10-15 minutes depending on your computer and your internet connectivity.
  4. When finished, the script will provide you with the IP addresses and admin account credentials for both UCP and DTR. Use your web browser of choice to log in to either product.  You may get a “connection is not private” warning which you must click through as the products are using self-signed TLS certificates.
  5. UCP and DTR are now wired up, licensed, and ready to test!



DTR preconfigured and ready to test…




and UCP preconfigured and ready to test!


Under the hood, the script uses docker-machine to create a boot2docker Virtual Machine. A local DNS server (dnsmasq) is used to serve the registry domain name within the VM. Both UCP and DTR are downloaded from Docker Hub, licensed using your license key file, and wired up together with default authentication settings. You can play around with the native Docker CLI client by downloading a UCP client bundle and sourcing it in your local environment. Please note that the domain name that is used by both products as a private docker registry, “”, will not be available from your browser as it is internal to the VM.

Note that DDC-In-A-Box is an unofficial script for quickly testing out Docker Datacenter on a single computer and is not suited for multi-node evaluation or production environments. For a more in-depth, multi-node evaluation of UCP we encourage you to check out the evaluation install documentation. If you have any questions about DDC-In-A-Box feel free to ask on the Universal Control Plane forums.


Learn More about Docker


5 thoughts on “Kick the Tires on Docker Datacenter with DDC-In-A-Box!

  1. Nice article!

    To support openstack driver, just add the following within the script:

    if [[ $MACHINE_DRIVER == 'openstack' ]]; then
    MACHINE_DRIVER_FLAGS="–openstack-auth-url=http://XXXX:10101/v3 –openstack-flavor-id=4 –openstack-image-name=fedora22 –openstack-domain-name=XXXXX –openstack-password=XXXX –openstack-tenant-name=XXXXX –openstack-ssh-port=22 –openstack-ssh-user=fedora –openstack-username=XXXX"

  2. Glenn J Simpson

    I keep getting this error when I try to use this on my Window's box.

    Error loading host: Error loading host: Host does not exist: "C"

  3. Glenn J Simpson

    Thanks for this script. I fixed my problem by changing the script scp line to hard code to my local environment.

  4. I have installed in Mac, downloading script and license. I didn;t get any error or anything. But cannot find out UCP or DTR is working. Can you please confirm the port numbers to access the web portal?

  5. Excellent thanks a lot for this. 15 minutes or so and I have a working DDC !

Leave a Reply