Before you begin: Installing Docker & Docker Compose

Whether you are testing the Enterprise DDI solution or preparing for full installation, you must first install Docker. Docker is a set of platform-as-a-service products that use OS-level virtualization to deliver software in packages called containers. For more information, go to http://docs.docker.com.

To install Docker:

1. Verify that you meet the minimum system requirements:
   • 4 CPUs
   • 8+GB RAM
   • 20+ GB of free disk space
     
     
2. Verify a new version of a supported Linux distribution has been installed. If evaluating NS1 Private DNS or Enterprise DDI, we recommend Ubuntu 18.04 LTS or CentOS 7.x.
   Note: While RedHat Enterprise Linux (RHEL) is supported, it is not recommended for test environments.
   
   
3. If applicable, remove any versions of Docker that may be pre-installed with your Linux distribution (as these versions might be older or incomplete). Later in the installation process, we'll install the newest Docker packages directly from the Docker project.
   
   
   • CentOS:

     sudo yum remove docker \
         docker-client \
         docker-client-latest \
         docker-common \
         docker-latest \
         docker-latest-logrotate \
         docker-logrotate \
         docker-engine \
         docker-compose

   • Ubuntu:

     sudo apt-get remove docker docker-engine \ 
         docker-compose docker.io containerd runc

4. Set up the Docker repository.
   • CentOS:
     

     sudo yum install -y yum-utils

     sudo yum-config-manager \
         --add-repo \
         https://download.docker.com/linux/centos/docker-ce.repo 

        
   • Ubuntu:
     

     sudo apt-get update

     sudo apt-get install \
         apt-transport-https \
         ca-certificates \
         curl \
         gnupg-agent \
         software-properties-common

     curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
        sudo apt-key add -

     sudo add-apt-repository \
        "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
        $(lsb_release -cs) \
        stable"   

           
5. Install and start Docker CE from the Docker repository.
   • CentOS:
     

     sudo yum install wget docker-ce docker-ce-cli containerd.io 

     sudo systemctl start docker

   • Ubuntu:
     

     sudo apt-get update 

     sudo apt-get install docker-ce docker-ce-cli containerd.io   

           
6. Install docker-compose:
   

   sudo curl -L \
       "https://github.com/docker/compose/releases/download/1.24.1/docker-compose-$(uname -s)-$(uname -m)" \
       -o /usr/local/bin/docker-compose

   sudo chmod +x /usr/local/bin/docker-compose

         
7. Verify the versions of Docker and docker-compose.
   

   docker -v

   docker-compose -v

   
   Note: The version of Docker should be 17.06 or above. The version of docker-compose should be 1.24 or above. 
   
      
8. In general, it is recommended to run Docker commands as a non-root user. By default, Docker commands will only be accessible via the root user. Run the following commands to grant your user account permissions to run the 'docker' command.  You may receive an error stating that the "docker" group already exists—this is OK.
   

   sudo groupadd docker

   sudo usermod -aG docker $USER

   logout

   Important: Once complete, you must logout and then log back in to activate your user's updated group permissions.
      
9. Run the "hello world" test. This ensures that Docker is properly installed and running. If everything is installed properly, you should receive a "Hello from Docker!" message.
   

   docker run hello-world

       

At this point, you have a fully operational Docker environment. Proceed to the Installation and Setup Guide for instructions on downloading, installing, and configuring Enterprise DDI. For assistance with the implementation process, contact your NS1 customer support representative or submit a ticket.