How to install Docker

The Percept container contains all necessary programs, algorithms and binaries to acquire, process and visualize point clouds. The provided Percept web interface lets you easily create, configure, start and visualize projects.

Windows

To run Percept on Windows you will need to have Docker and the Windows Subsystem for Linux 2 short WSL2 setup on your PC.

  1. To install Docker on Windows please follow this recipe from the official Docker website:

After installing Docker, the "Docker Desktop" Application should be available and the docker command should be executable inside the Windows Command Line Tool as cmd-prompt.

Docker Desktop GUI
Figure 1. Docker Desktop GUI

If your version of Windows supports WSL2 (Windows subsystem for Linux) we recommend enabling and using it as a backend for Docker for Windows.

Docker for Windows detects if your system is capable of using WSL2. Follow the steps in the Docker GUI to install and enable WSL2. Further information can be found on the Docker website: Docker WSL2 integration

If WSL2 is not installed Docker is using the Hyper-V backend to execute containers which might lead to lower performance in compute-heavy or IO-intensive applications.

To finish the installation of Docker, please reboot your PC.

Ubuntu

To run Percept you will need to install Docker on your Ubuntu machine.

  1. To install Docker on Ubuntu please follow this recipe from the official Docker website (We tested it with "install using the repository"):

Percept also requires docker-compose. You can either install it with apt install docker-compose or by following the docker documentation Install Docker Compose

To finish the installation of Docker, please reboot your PC.

Required Docker Version

Please make sure that you have at least the docker version 20.10.XX

on Windows you can check the version either

  1. use the command line and enter docker --version

  2. or have a look in the docker desktop gui under settings (docker engine version)

Docker Version
Figure 2. Image shows the docker version (in the docker engine section) denoted as v20.10.12

on Ubuntu

  1. open a terminal and enter docker --version