Whether your are testing the Private DNS or 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:
- Verify that you meet the minimum system requirements:
- 4 CPUs
- 8+GB RAM
- 20+ GB of free disk space
- 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.
- 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.
sudo yum remove docker \
sudo apt-get remove docker docker-engine \
docker-compose docker.io containerd runc
- Set up the Docker repository.
sudo yum install -y yum-utils
sudo yum-config-manager \
sudo apt-get update
sudo apt-get install \
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) \
- Install and start Docker CE from the Docker repository.
sudo yum install wget docker-ce docker-ce-cli containerd.io
sudo systemctl start docker
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io
- Install docker-compose:
sudo curl -L \
"https://github.com/docker/compose/releases/download/1.24.1/docker-compose-$(uname -s)-$(uname -m)" \
sudo chmod +x /usr/local/bin/docker-compose
- Verify the versions of Docker and docker-compose.
Note: The version of Docker should be 17.06 or above. The version of docker-compose should be 1.24 or above.
- 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
logoutImportant: Once complete, you must logout and then log back in to activate your user's updated group permissions.
- 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
- Download the NS1 get_privatedns.sh script:
- Execute the get_privatedns.sh script. Note: You will need an NS1 API key with the proper entitlements for this script to execute properly. Your sales representative will provide you with this key if you do not already have one. Replace <yourapikey> with the given API key (without brackets).
sh ./get_privatedns.sh -k $APIKEY
This process may take several minutes or longer depending on your connection speed and other factors. Once the download is complete, connect with your NS1 sales engineer for the remaining setup instructions or refer to Installation & Setup Guide: Private DNS + Enterprise DDI [platform v2.0+].