Although we can install Docker and Docker Compose from the official Ubuntu repositories, they are several minor versions behind the latest release. So, we'll install Docker following the official documentation page (https://docs.docker.com/install/linux/docker-ce/ubuntu/).
# Uninstall old versions
$ sudo apt-get remove docker docker-engine docker.io containerd runc
# Update the apt package index
$ sudo apt-get update
# Install packages to allow apt to use a repository over HTTPS:
$ sudo apt-get install \
apt-transport-https \
ca-certificates \
curl \
gnupg-agent \
software-properties-common
# Add Docker’s official GPG key
$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
# Use the following command to set up the stable repository.
$ sudo add-apt-repository \
"deb [arch=amd64] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) \
stable"
# Update the apt package index.
$ sudo apt-get update
# Install the latest version of Docker CE and containerd
$ sudo apt-get install docker-ce docker-ce-cli containerd.io
Verify that Docker CE is installed correctly by running the hello-world image.
$ sudo docker run hello-world
This command downloads a test image and runs it in a container. When the container runs, it prints an informational message and exits.
Now Docker CE is installed and running.
Enable the docker system service to start docker when the system boots:
$ sudo systemctl enable docker
To disable this behavior, use disable instead.
$ sudo systemctl disable docker
By default, you need to use sudo to run Docker commands.
If you don’t want to use sudo when you use the docker command, create a Unix group called docker and add users to it.
Warning: The docker group is root-equivalent; see Docker Daemon Attack Surface details and this blogpost on Why we don't let non-root users run Docker in CentOS, Fedora, or RHEL.
To create the docker group and add your user:
1- Add the docker group if it doesn't already exist
$ sudo groupadd docker
2- Add your user to the docker group.
$ sudo usermod -aG docker $USER
Other optional configuration steps: (https://docs.docker.com/install/linux/linux-postinstall/)
In order to manage and execute docker-compose files we need to install the Docker Compose package.
The command below is slightly different than the one you'll find on the Releases page. By using the -o flag to specify the output file first rather than redirecting the output, this syntax avoids running into a permission denied error caused when using sudo.
Go to https://docs.docker.com/release-notes/docker-compose/ and look for the last release of docker-compose.
We'll check the current release and if necessary, update it in the command below:
$ sudo curl -L https://github.com/docker/compose/releases/download/1.23.0/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
Next we'll set the permissions:
sudo chmod +x /usr/local/bin/docker-compose
Then we'll verify that the installation was successful by checking the version:
docker-compose --version
This will print out the version we installed:
Output
docker-compose version 1.23.0, build a133471