5.7 KiB

Raw Blame History

+++ title = "Manually Install the CS Docker Engine" description = "Install instructions for the commercially supported Docker Engine" keywords = ["docker, documentation, about, technology, enterprise, hub, commercially supported Docker Engine, CS engine, registry"] [menu.main] parent="smn_dhe_install" +++

Manually Install the CS Docker Engine

This document describes the process of obtaining and installing the Commercially Supported Docker Engine (CS Engine). Installing CS Engine is a prerequisite for installing the Docker Trusted Registry. You can use these instructions if you are installing CS Engine on physical or cloud infrastructure.

If your cloud provider is AWS, you have the option of installing CS Engine using an Amazon Machine Image (AMI) instead. For more information, read the installation overview to understand your options.

Prerequisite

Installing CS Engine requires that you have a login to Docker Hub. If you have not already done so, go to Docker Hub and sign up for an account.

Also, you must have a license for Docker Trusted Registry. This license allows you to run both Docker Trusted Registry and CS Engine. Before installing, purchase a license or sign up for a free, 30 day trial license.

Install on CentOS 7.1 & RHEL 7.0/7.1

This section explains how to install on CentOS 7.1 & RHEL 7.0/7.1. Only these versions are supported. CentOS 7.0 is not supported. On RHEL, depending on your current level of updates, you may need to reboot your server to update its RHEL kernel.

Log into the system as a user with root or sudo permissions.
Update your yum repositories.
```
 $ sudo yum update && sudo yum upgrade
```
In a browser, log in to the Docker Hub with the account you used to obtain your license.
Once you're logged in, go to your account's Licenses page.
In the "Download and Install CS Engine" locate the script appropriate to your system.

Copy the script, paste it into your terminal, and press Return.

 $ curl -s
 https://packagecloud.io/install/repositories/Docker/cs-public/script.rpm.sh |
 sudo bash sudo yum install docker-engine-cs

After the command completes, install the CS Engine with the following command:
```
 $ sudo yum install docker-engine-cs
```

Enable the Docker daemon as a service and then start it.

 $ sudo systemctl enable docker.service
 $ sudo systemctl start docker.service

Verify the installation was successful by running a simple container.

 $ sudo docker run hello-world
 Unable to find image 'hello-world:latest' locally
 latest: Pulling from hello-world
 b901d36b6f2fd75: Pull complete
 0a6ba66e537a53a: Pull complete
 hello-world:latest: The image you are pulling has been verified. Important: image verification is a tech preview feature and should not be relied on to provide security.
 Digest: sha256:517f03be3f8169d84711c9ffb2b3235a4d27c1eb4ad147f6248c8040adb93113
 Status: Downloaded newer image for hello-world:latest

 Hello from Docker.
 This message shows that your installation appears to be working correctly.

 To generate this message, Docker took the following steps:
  1. The Docker client contacted the Docker daemon.
  2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
  3. The Docker daemon created a new container from that image which runs the
     executable that produces the output you are currently reading.
  4. The Docker daemon streamed that output to the Docker client, which sent it
     to your terminal.

 To try something more ambitious, you can run an Ubuntu container with:
  $ docker run -it ubuntu bash

 Share images, automate workflows, and more with a free Docker Hub account:
  https://hub.docker.com

 For more examples and ideas, visit:
  https://docs.docker.com/userguide/

Optionally, add non-sudo access to the Docker socket by adding your user to the docker group.
```
$ sudo usermod -a -G docker $USER
```

Log out and log back in to have your new permissions take effect.

Install on Ubuntu 14.04 LTS

Log into the system as a user with root or sudo permissions.

Update your yum repositories.

 $ sudo apt-get update && sudo apt-get upgrade

Install additional virtual drivers not in the base image.
```
 $ sudo apt-get install -y linux-image-extra-virtual
```
You may need to reboot your server to after updating the LTS kernel.
In a browser, log in to the Docker Hub with the account you used to obtain your license.
Once you're logged in, go to your account's Licenses page.
In the "Download and Install CS Engine" locate the script appropriate to your system.