Docker runtime
==============

If the Linux distribution you are using ships a recent enough Docker version as
specified in the system requirements, you are free to install the distribution
version of Docker.

Docker
------

.. warning::
    Docker installed using Ubuntu Snap can be error prone or not work at
    all. The Ubuntu Snap version of Docker is not supported.

To ensure that you have the latest version you can use Docker's own repository,
here are the link for docker engine installation instructions on Linux server, 

https://docs.docker.com/engine/install/#server

find your Linux distribution and follow the guide.

Once Docker is installed verify that you can run a container with:

.. code-block:: bash

    docker run --rm hello-world

Upon success some text including "Hello from Docker!" will appear on your
screen.

.. note::
    If you receive a permission denied error stating that you can't connect to
    the Docker socket, be aware that by default only the root user, or members
    of the "docker" group are allowed access. You might need to run sudo
    before your various Docker commands.

Docker Compose
--------------

Docker Compose is used to manage the Device Onboarding application stack and 
is one of the default packages installed when going though the Docker installation steps.
Try to verify Docker Compose plugin is installed on your system

.. code-block:: bash

    docker compose version

It should output something like "Docker Compose version v2.12.0", if not check the installation 
documentation for Docker Compose here:

https://docs.docker.com/compose/install/linux/