Install Docker Engine

This guide will walk you through the installation of Docker Engine on popular Linux platforms such as Ubuntu, Raspberry Pi OS, Debian, and Alpine Linux.

ollow the steps below to get Docker up and running on your system. If you are missing an OS or you would like to learn more about Docker, please visit the official Docker page.

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

Prerequisites

Before you begin, ensure that you have the following:

  • A 64-bit version of your Linux distribution.

  • Sudo privileges on the system.

Installation Steps

You can go directly to the section of your OS:

Ubuntu

  1. Update the Package Index:

    sudo apt-get update
  2. Install Required Packages:

    sudo apt-get install ca-certificates curl gnupg lsb-release
  3. Add Docker’s Official GPG Key:

    sudo mkdir -p /etc/apt/keyrings
    curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
  4. Set Up the Docker Repository:

    echo \
      "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
      $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
  5. Install Docker Engine:

    sudo apt-get update
    sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
  6. Verify the Installation:

    sudo docker run hello-world

Raspberry Pi OS

  1. Update the Package Index:

    sudo apt-get update
    sudo apt-get upgrade
  2. Download and Run the Docker Installation Script:

    curl -fsSL https://get.docker.com -o get-docker.sh
    sudo sh get-docker.sh
  3. Add Your User to the Docker Group:

    sudo usermod -aG docker $USER
  4. Verify the Installation:

    docker run hello-world

Debian

  1. Update the Package Index:

    sudo apt-get update
  2. Install Required Packages:

    sudo apt-get install ca-certificates curl gnupg lsb-release
  3. Add Docker’s Official GPG Key:

    sudo mkdir -p /etc/apt/keyrings
    curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
  4. Set Up the Docker Repository:

    echo \
      "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian \
      $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
  5. Install Docker Engine:

    sudo apt-get update
    sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
  6. Verify the Installation:

    sudo docker run hello-world

Alpine Linux

  1. Update the Package Index:

    sudo apk update
  2. Install Docker:

    sudo apk add docker
  3. Start the Docker Daemon:

    sudo service docker start
  4. Add Your User to the Docker Group:

    sudo addgroup $USER docker
  5. Verify the Installation:

    docker run hello-world

Post-Installation Steps

After installing Docker, you may want to configure Docker to start on boot:

sudo systemctl enable docker

To check the status of Docker:

sudo systemctl status docker

Troubleshooting

If you encounter any issues, ensure that:

  • Your system meets the prerequisites.

  • You have followed each step correctly.

  • You have a stable internet connection during the installation process.

As soon as the docker engine is up and running, you can go back to "Add Device" and continue with insalling the Agent on the device.

Last updated