Table of Contents |
---|
Windows
Requirements
- Windows version:
- Windows 11 64-bit: Home or Pro version 21H2 or higher.
- Windows 10 64-bit: Home or Pro 21H1 (build 19043) or higher.
- Verify by opening the Windows menu, then type: 'system information' and search in the version line, there you will find the build number. Update Windows if necessary.
- Enable the WSL 2 (Windows Subsystem for Linux) backend:
- In the PowerShell terminal type:
wsl --install -d ubuntu-20.04
This will install the Windows subsystem for Linux with the Ubuntu 20.04 distro. - After installing WSL, it will be necessary to restart your computer. Then there will be a short installation and activation process that will ask you to set a user name and an administrator password.
- In the PowerShell terminal type:
- Your system must have at least 4GB of RAM
- Hardware virtualization must be active in the BIOS
- Enter the BIOS at start up and there access CPU configurations, then enable virtualization (e.g. VT-x, AMD-V, SVM, Vanderpool)
- Open the Windows menu and type 'Turn Windows Features on or off'. There, check that 'Virtual Machine Platform' and 'Windows Subsystem for Linux' are selected.
For further details, please visit https://learn.microsoft.com/en-us/windows/wsl/install-manual
Installation
- Download Docker for Windows (https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe)
- Execute the
Docker Desktop Installer.exe
file to install the software as usual. - If requirement 2. above was not done or did not worked well, it is possible that during the installation Docker asks to install the WSL 2 components. Please select this option.
Note: If there is a Firewall warning asking to allow Docker to connect to private and/or public networks, please allow both connections.
More details in https://docs.docker.com/desktop/install/windows-install/
Apple
For Mac (Intel)
Requirements
- MacOS must be version 10.15 or newer. That is, Catalina, Big Sur, or Monterey.
- If you have VirtualBox with a version lower than 4.3.30, you have to uninstall it or upgrade it.
Installation
- Download Docker for Mac (Intel): https://desktop.docker.com/mac/main/amd64/Docker.dmg?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-mac-amd64
- Install the
Docker.dmg
file as with any other application, and accept the subscription agreement.
For Mac (M1)
Requirements
- To get the best experience, Docker recommends to install Rosetta 2. To install Rosetta 2, open the Terminal and type:
softwareupdate --install-rosetta
Installation
- Download Docker for Mac (M1 chip): https://desktop.docker.com/mac/main/arm64/Docker.dmg?utm_source=docker&utm_medium=webreferral&utm_campaign=docs-driven-download-mac-arm64
- Install the
Docker.dmg
file as with any other application, and accept the subscription agreement.
More details in https://docs.docker.com/desktop/install/mac-install/
Linux
This example uses the Ubuntu distro. For specific instructions on other distros please visit: https://docs.docker.com/desktop/install/linux-install/
Requirements
- Have a 64-bit version of either Ubuntu Jammy Jellyfish 22.04 (LTS) or Ubuntu Impish Indri 21.10. Docker Desktop is supported on
x86_64
(oramd64
) architecture. - For non-Gnome Desktop environments,
gnome-terminal
must be installed:
Code Block | ||
---|---|---|
| ||
sudo apt install gnome-terminal |
Installation
IMPORTANT: Docker Desktop on Linux runs a Virtual Machine (VM). This means images and containers deployed on the Linux Docker Engine (before installation) are not available in Docker Desktop for Linux.
This is a simplified, step-by-step version of the required commands to install Docker from the terminal. For further details and additional commands see the detailed instructions.
Uninstall the tech preview or beta version of Docker Desktop:
Code Block | ||
---|---|---|
| ||
sudo apt remove docker-desktop |
For a complete cleanup, remove configuration and data files at $HOME/.docker/desktop
, the symlink at /usr/local/bin/com.docker.cli
, and purge the remaining system service files with:
Code Block | ||
---|---|---|
| ||
rm -r $HOME/.docker/desktop sudo rm /usr/local/bin/com.docker.cli sudo apt purge docker-desktop |
Set up the repository
Update the apt package index and install packages to allow apt to use a repository over HTTPS:
Code Block | ||
---|---|---|
| ||
sudo apt-get update sudo apt-get install \ ca-certificates \ curl \ gnupg \ lsb-release |
Add Docker’s official GPG key:
Code Block | ||
---|---|---|
| ||
sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg |
Set up the repository:
Code Block | ||
---|---|---|
| ||
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 |
Install Docker
Download the latest DEB package from https://docs.docker.com/desktop/install/linux-install/.
Update the package index:
Code Block | ||
---|---|---|
| ||
sudo apt-get update |
Navigate to the folder where the file is stored, e.g.:
Code Block |
---|
cd Downloads |
Run the command sudo apt-get install ./
writing afterwards the exact name and extension of the file downloaded, e.g.:
Code Block | ||
---|---|---|
| ||
sudo apt-get install ./docker-desktop-4.14.1-amd64.deb |
Launch Docker with:
Code Block | ||
---|---|---|
| ||
systemctl --user start docker-desktop |