Step 1. Downloading and Installing Docker
Docker Desktop requires a paid license for business usage in companies above a certain size. As an alternative, you can use Rancher Desktop instead.
Docker Desktop
The easiest and most recommended way to get Docker and Docker Compose is to install Docker Desktop. Docker Desktop includes Docker Compose along with Docker Engine and Docker CLI which are Compose prerequisites. The exception is when you are using a Linux server from command line. In that case, Docker Desktop for Linux is not useful.
Instructions for Linux Computers
Docker supports several Linux distributions (e.g., Ubuntu, RHEL etc.). Please refer to the documentation on docs.docker.com and follow the instructions relevant for your Linux distribution. Also ensure that you are using a Linux release version supported by Docker. For example, this page provides instructions for installing Docker Engine on Ubuntu Linux. Find the corresponding documentation for the Linux version you are using here: https://docs.docker.com/engine/install/ubuntu/.
While Docker Desktop is available for Linux in the form of a Virtual Machine, you should not involve Docker Desktop for Linux for the purpose of running the Panopticon Docker Compose package. Instead, you should install only the Docker Engine, which is managed through a command line interface (CLI).
Instructions for Apple Computers
On macOS, Docker is available as Docker Desktop. Please follow the instructions provided by Docker to install. .
NOTE:
In case you are running macOS on Apple Silicon hardware, such as M1 (not Intel), you will need to enable Rosetta emulation in Docker Desktop.
You may need to upgrade macOS if you are running < Ventura 13.5.
Instructions for Windows Computers
On Windows, Docker is available as Docker Desktop. Please follow the instructions provided by Docker.
NOTE:
On Windows, one possibility is also to open a WSL prompt and follow the installation instructions for Linux to get Docker on your system in a way that avoids the Windows installation of Docker Desktop. You should not take this approach if your Windows system also has Docker Desktop installed, since it may give confusing results when starting and stopping containers.
If you do choose to install Docker Engine on your WSL command line, note that you may have to change the name “credsStore” into “credStore” in the ~/.docker/config.json file.
You may also find that you need to modify the WSL user's group membership / permissions:
sudo usermod -aG docker $USER
sudo chmod 666 /var/run/docker.sock
Warning: By installing the Docker engine in your WSL Linux environment, you will not be able to use the Data Store feature in Panopticon, because of a connection error between the Panopticon container and the MonetDB container. You will see an error logged in Panopticon saying:
SEVERE: [ImportDataService] Unable to connect (Data Store): Connection refused.
The MonetDB log (merovingian.log) will show the following:
ERR monetdb[43]: #main thread: createExceptionInternal: ERROR: IOException:mal_mapi.listen:operation failed: binding to UNIX socket file /var/monetdb5/dbfarm/monetdb/.mapi.sock failed: Operation not supported
MSG merovingian[10]: database 'monetdb' (43) has exited with exit status 1
The issues are further discussed here: https://github.com/MonetDB/MonetDB/issues/7069
Rancher Desktop by SUSE
Rancher Desktop by SUSE is an open-source application that provides all the essentials to work with containers and Kubernetes on the desktop.
Instructions for Linux Computers
Linux users can install via popular package managers. Read more about requirements and installation steps on https://docs.rancherdesktop.io/getting-started/installation/#linux
Instructions for Windows Computers
- Download the MSI file for installation on Windows, from https://rancherdesktop.io/.
- Run the MSI file to install.
- Start Rancher Desktop.
- In Preferences, for the Container Engine, select dockerd (moby) to be able to use the same commands as with Docker.
Read more about requirements on https://docs.rancherdesktop.io/getting-started/installation/#windows.
Instructions for Apple Computers
- Download the suitable DMG installer for either Apple Silicon or Intel from https://rancherdesktop.io/.
- Double-click the DMG file.
- In the Finder window that opens, drag the Rancher Desktop icon to the Applications folder.
- Navigate to the Applications folder and double-click the Rancher Desktop to launch it.
- In Preferences, for the Container Engine, select dockerd (moby) to be able to use the same commands as with Docker.
Read more about requirements on https://docs.rancherdesktop.io/getting-started/installation/#macos.
(c) 2013-2024 Altair Engineering Inc. All Rights Reserved.