Docker installation - Storm Streaming Server

Docker is a great way of deploying Storm Streaming Server on your server infrastructure. This guide describes in detail how to install Docker on a Linux (Debian-based distributions), Windows and Mac OS X. All Storm Streaming Server Docker images come with pre-installed JVM, so there is no need to set it up manually. Once the Docker is up and running on your machine, please check our Installation guide for Docker.

If you are unfamiliar with Docker and its concept, we highly advice to check docker.com for more info.

Installing Docker on Linux - part 1

This guide is dedicated to Debian (along Ubuntu, Mint), but the whole process will not differ substantially from other Linux-based operating systems like RedHat or Fedora. In our first step, we'll make sure to grab the latest version of Docker directly from Docker repository (as packages provided by Debian might not be the latest).

First, update existing package list:

                        
sudo apt update
                    

Next, install a few prerequisite packages which let apt use packages over HTTPS:

                        
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:

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

Add the Docker repository to APT sources:

                        
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:

                        
sudo apt update
                    

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

                        
apt-cache policy docker-ce
                    

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

                        
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:

                        
sudo apt install docker-ce
                    

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

                        
sudo service docker status
                    

The output should looks like this:

                        
● 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
                    

Installing Docker on Linux - part 2 (optional)

By default, the docker command can only be run 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:

                        
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:

                        
sudo usermod -aG docker $USERNAME
                    
Where $USERNAME is the actual name of your user!

Installing Docker on Windows

Docker for Windows operating system is available for download with an easy-to-use installer. You can grab it form here: https://www.docker.com/products/docker-desktop, Once the package is download just double-click the exe file and follow instructions to the end.

Installing Docker on Mac OS

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