Docker Installation Tutorial - Storm Streaming Server

Installing Docker on Linux

This guide is specifically for Debian (including Ubuntu and Mint), but the overall process will not differ significantly for other Linux-based operating systems like RedHat or Fedora. In the first step, we will ensure that we obtain the latest version of Docker directly from the Docker repository (as the packages provided by Debian might not be the latest).

First, update the existing package list:

Update packages

bash

Copy

sudo apt update

Next, install a few prerequisite packages that allow apt to use packages over HTTPS:

Install prerequisites

bash

Copy

sudo apt install apt-transport-https ca-certificates curl gnupg2 software-properties-common

Then add the GPG key for the official Docker repository to your system:

Add GPG key

bash

Copy

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

Add the Docker repository to APT sources:

Add Docker repository

bash

Copy

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

Next, update the package database with the Docker packages from the newly added repo:

Update package database

bash

Copy

sudo apt update

Make sure you are about to install from the Docker repo instead of the default Debian repo:

Check Docker source

bash

Copy

apt-cache policy docker-ce

You'll see output like this, although the version number for Docker may be different:

Expected output

text

Copy

docker-ce:
  Installed: (none)
  Candidate: 5:20.10.7~3-0~debian-buster
  Version table:
    5:20.10.7~3-0~debian-buster 500
      500 https://download.docker.com/linux/debian buster/stable amd64 Packages
              ...

Finally, install Docker:

Install Docker

bash

Copy

sudo apt install docker-ce

Docker is now installed, the daemon is started, and the process is enabled to start on boot. Check that it is running:

Check Docker status

bash

Copy

sudo systemctl status docker

Expected output

text

Copy

● docker.service - Docker Application Container Engine
  Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
  Active: active (running) since Mon 2021-06-28 13:55:43 CEST; 1min 33s ago
   Docs: https://docs.docker.com
 Main PID: 14558 (dockerd)
   Tasks: 24
  Memory: 56.9M
  CGroup: /system.slice/docker.service
     └─14558 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock

Adding User Privileges for Docker

By default, the docker command can only be run by the root user or by a user in the docker group, which is automatically created during Docker's installation process. If you attempt to run the docker command without prefixing it with sudo or without being in the docker group, you'll get an output like this:

Permission error

text

Copy

docker: Cannot connect to the Docker daemon. Is the docker daemon running on this host?.
See 'docker run --help'.

If you want to avoid typing sudo whenever you run the docker command, add your username to the docker group:

Add user to docker group

bash

Copy

sudo usermod -aG docker $USERNAME

Installing Docker on Windows

Docker for Windows operating system is available for download with an easy-to-use installer. You can grab it from here: https://www.docker.com/products/docker-desktop.

Once the package is downloaded, just double-click the exe file and follow instructions to the end.

Installing Docker on Mac OS

Docker for Mac OS is also available for download with a friendly installer: https://www.docker.com/products/docker-desktop.

Useful Links

1. Docker commands - https://docs.docker.com/engine/reference/commandline/docker/
2. Docker documentation - https://docs.docker.com/
3. Docker Hub - https://hub.docker.com/