Skip to content

Latest commit

 

History

History
96 lines (58 loc) · 3.64 KB

INSTALLING_DOCKER.md

File metadata and controls

96 lines (58 loc) · 3.64 KB
Raw

Installing Docker

In order to run containers like taltechivarlab/ubuntu-desktop on your machine, you will need to install Docker Engine.

Installation steps are already detailed well in the official guides, so here we will only provide links to those and a short TL;DR for each platform.

🪟 Windows

Guide: install Docker Desktop with WSL backend

TL;DR:

  1. Install Windows Subsystem for Linux (WSL2)
  2. Download & install Docker Desktop for Windows
  3. Launch Docker Desktop

🍎 Mac

Guide: install Docker Desktop

TL;DR:

  1. Download and install Docker Desktop for Mac
  2. Launch Docker Desktop

🐧 Linux

Guide: install Docker Engine

TL;DR:

The commands differ depending on the Linux distribution, so if you want to install it manually, your best bet is checking the official guide for your distro. However, Docker provides a convenience installation script which works on most Linux distributions. With the script, installation steps become the following:

  1. Download the installation script:

    curl -fsSL https://get.docker.com -o get-docker.sh

  2. Run the installation script:

    ⚠️ Before you install, it's a good practice to check if the contents of the downloaded get-docker.sh match the ones of the original installation script from Docker's GitHub.

    sudo sh get-docker.sh

  3. (optional) Add your user to the docker group.

    ℹ️ This will allow you to run docker ... commands without typing sudo in front every time you use them.

    1. Add docker group to your system:

      sudo groupadd docker

      💡 If you want to learn more about how group and user permissions work in Linux, we highly recommend watching this video tutorial by NetworkChuck.

    2. Add your user to this group:

      sudo usermod -aG docker $USER

    3. Log out and back in for group changes to take effect.

Testing your installation

To test your Docker installation, run the official hello-world container from your terminal:

docker run hello-world

ℹ️ If your Docker is running correctly, this command will result in a confirmation message with some additional info about how Docker got it done.