Install and configure Docker¶

You can follow the official documentation depending on your Linux distribution.

You might want to allow non-root users to run Docker following the post-install documentation.

The Compose plugin has to be installed externally to work. You can install it with your package manager with the related documentation.

For Debian, you can execute the following commands to install Docker with the Compose plugin.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

# Uninstall old versions
sudo apt remove docker docker-engine docker.io containerd runc

# Update the available package lists
sudo apt update

# Install required packages to add Docker's repository
sudo apt install \
	ca-certificates \
	curl \
	gnupg \
	lsb-release

# 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

# Set up the 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

# Update the available package lists
sudo apt update

# Install Docker and the Compose plugin
sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin

# Create the `docker` group (it might already exist)
sudo groupadd docker

# Add your user to the `docker` group
sudo usermod -aG docker $USER

# Activate the changes to group
newgrp docker

Download and install Docker Desktop from the official website. You can then start Docker Desktop and you should be good to go.

Install Windows Subsystem for Linux (WSL)¶

On Windows, it is highly recommended to install a WSL distribution. You can follow the official documentation to install your Linux distribution.

For the default Ubuntu WSL distribution, you can execute the following steps.

First, download and install the Linux kernel update package

Press the Win key. Search for Powershell. Right-click on it, and select Run as administrator. Type the following commands. You'll be asked to create a new user in the WSL Linux distribution with its password.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# Set default version of WSL to 2
wsl --set-default-version 2

# Install Ubuntu WSL
wsl --install --distribution Ubuntu

# Set Ubuntu as the default WSL
wsl --setdefault Ubuntu

# Update WSL just to be sure
wsl --update

Verify in the Powershell that the version on WSL is the right with wsl -l -v, the output should looks like that.

1
2

> NAME		STATE			Version
> Ubuntu	Running			2

Once the process of installing your Linux distribution with WSL is complete, open the distribution Ubuntu using the Start menu. This will open a command line in your distribution. You will be asked to create a User Name and Password for your Linux distribution.

Install Docker¶

Once the WSL has been installed, download and install Docker Desktop from the official website. Restart your computer. You can then start Docker Desktop and you should be good to go.

Troubleshooting

If your Ubuntu log into a root user, it means your installation process of Ubuntu was aborted. Like NotTheDr01ds said on ask.ubuntu.com:

1
2

wsl --unregister Ubuntu
ubuntu.exe

1
2
3
4
5
6

# Create an encrypted version of your password
echo "Password" | openssl passwd -1 -stdin
> encryptedPassword

# Create the user
useradd --create-home --user-group --groups  adm,dialout,cdrom,floppy,sudo,audio,dip,video,plugdev,netdev --password "encryptedPassword" username

1
2

[user]
default=username