Estimated analyzing time: thirteen mins
Commercial use of Docker Desktop in larger organizations (more than 250employees OR greater than $10 million USD in annual revenue) requires a paidsubscription.
This page incorporates records approximately machine requirements, download URLs, and commands on the way to install and replace Docker Desktop for Linux.
During first set up make certain to satisfy the gadget necessities mentioned under and follow the distro-precise installation instructions:UbuntuDebianFedora
gentoobr.org RPM packageDEB packageArch bundle (experimental)System requirements
To install Docker Desktop effectively, your Linux host ought to meet the following requirements:
64-bit kernel and CPU assist for virtualization.
KVM virtualization assist. Follow the KVM virtualization guide commands to check if the KVM kernel modules are enabled and the way to offer get entry to to the kvm tool.
QEMU must be model 5.2 or more recent. We propose upgrading to the modern-day version.
systemd init machine.Gnome or KDE Desktop surroundings.For many Linux distros, the Gnome environment does not assist tray icons. To upload help for tray icons, you need to install a Gnome extension. For example, AppIndicator).
At least four GB of RAM.Enable configuring ID mapping in user namespaces, see File sharing.
Docker Desktop for Linux runs a Virtual Machine (VM). For more facts on why, see Why Docker Desktop for Linux runs a VM.
Docker does now not provide support for going for walks Docker Desktop in nested virtualization situations. We suggest that you run Docker Desktop for Linux natively on supported distributions.Supported structures
Docker affords .deb and .rpm programs from the subsequent Linux distributionsand architectures:
An experimental package is available for Arch-primarily based distributions. Docker has not examined or tested the installation.
Docker helps Docker Desktop at the cutting-edge LTS release of the aforementioned distributions and the maximum current version. As new versions are made available, Docker stops helping the oldest model and helps the newest version.KVM virtualization guide
Docker Desktop runs a VM that calls for KVM help.
The kvm module ought to load mechanically if the host has virtualization assist. To load the module manually, run:
Depending on the processor of the host system, the corresponding module have to be loaded:$ modprobe kvm_intel# Intel processors$ modprobe kvm_amd# AMD processors
If the above commands fail, you may view the diagnostics through jogging:
To test if the KVM modules are enabled, run:$ lsmod tool consumer permissions
To test ownership of /dev/kvm, run :
Add your person to the kvm group to be able to get entry to the kvm device:$ sudo usermod -aG kvm $USER
Log out and log back in so that your institution membership is re-evaluated.Generic installation stepsDownload the perfect package in your Linux distribution and installation it with the corresponding package manager.Install on DebianInstall on FedoraInstall on UbuntuInstall on Arch
Open your Applications menu in Gnome/KDE Desktop and search for Docker Desktop.
Select Docker Desktop to begin Docker. The Docker menu () presentations the Docker Subscription Service Agreement window.
Select Accept to hold. Docker Desktop starts offevolved after you take delivery of the terms.
If you do not comply with the terms, the Docker Desktop application will near andyou can no longer run Docker Desktop for your system. You can select to accept the terms at a later date via starting Docker Desktop.
For greater records, see Docker Desktop Subscription Service Agreement. We endorse which you also read the FAQs.Differences among Docker Desktop for Linux and Docker Engine
Docker Desktop for Linux and Docker Engine may be installed side-by way of-aspect on thesame device. Docker Desktop for Linux shops bins and photographs in an isolatedstorage region within a VM and offerscontrols to limit its assets. Using a dedicated storagelocation for Docker Desktop prevents it from interfering with a Docker Engineinstallation at the equal system.
While it’s feasible to run both Docker Desktop and Docker Engine concurrently,there can be situations where going for walks each at the equal time can cause issues.For example, when mapping community ports (-p / –submit) for packing containers, bothDocker Desktop and Docker Engine can also attempt to reserve the identical port on yourmachine, that could cause conflicts (“port already in use”).
We usually endorse preventing the Docker Engine even as you’re using Docker Desktopto prevent the Docker Engine from consuming assets and to prevent conflictsas defined above.
Use the subsequent command to prevent the Docker Engine carrier:$ sudo systemctl stop docker docker.socket containerd
Depending for your installation, the Docker Engine can be configured to automaticallystart as a device service while your device starts. Use the following command todisable the Docker Engine provider, and to save you it from beginning automatically:$ sudo systemctl disable docker docker.socket containerdSwitch among Docker Desktop and Docker Engine
The Docker CLI can be used to have interaction with more than one Docker Engines. For instance,you can use the same Docker CLI to control a local Docker Engine and to controla far flung Docker Engine instance walking within the cloud. Docker Contextsallow you to exchange between Docker Engines instances.
When putting in Docker Desktop, a dedicated “desktop-linux” context is created tointeract with Docker Desktop. On startup, Docker Desktop routinely sets itsown context (computing device-linux) because the modern context. This means that subsequentDocker CLI commands goal Docker Desktop. On shutdown, Docker Desktop resetsthe current context to the default context.
Use the docker context ls command to view what contexts are to be had on yourmachine. The contemporary context is indicated with an asterisk (*);$ docker context lsNAMEDESCRIPTIONDOCKER ENDPOINT…default *Current DOCKER_HOST based configurationunix:///var/run/docker.sock…computer-linuxunix:///home/
If you have got both Docker Desktop and Docker Engine set up on the identical device,you could run the docker context use command to switch among the Docker Desktopand Docker Engine contexts. For example, use the “default” context to interactwith the Docker Engine;$ docker context use defaultdefaultCurrent context is now “default”
And use the laptop-linux context to engage with Docker Desktop:$ docker context use computer-linuxdesktop-linuxCurrent context is now “laptop-linux”
Refer to the Docker Context documentation for extra info.Updates
Once a new edition for Docker Desktop is released, the Docker UI suggests a notification.You want to download the brand new bundle whenever you need to improve manually.
To upgrade your set up of Docker Desktop, first forestall any instance of Docker Desktop strolling locally,then follow the normal installation steps to put in the new edition on pinnacle of the existingversion.Uninstall Docker Desktop
Docker Desktop can be removed from a Linux host the usage of the package deal supervisor.
Once Docker Desktop has been removed, customers ought to eliminate the credsStore and currentContext houses from the ~/.docker/config.json.
Uninstalling Docker Desktop destroys Docker packing containers, pics, volumes, andother Docker associated statistics nearby to the device, and gets rid of the files generatedby the utility. Refer to the back up and repair datasection to discover ways to preserve crucial facts earlier than uninstalling.Why Docker Desktop for Linux runs a VM
Docker Desktop for Linux runs a Virtual Machine (VM) for the subsequent motives:
To make sure that Docker Desktop presents a constant experience throughout systems.
During research, the most often noted reason for customers looking Docker Desktop for Linux (DD4L) changed into to make sure a steady Docker Desktopexperience with characteristic parity throughout all main operating structures. Utilizinga VM ensures that the Docker Desktop experience for Linux users will closelymatch that of Windows and macOS.
This need to supply a constant enjoy across all principal OSs turns into an increasing number of important as we look closer to adding thrilling new capabilities, which include Docker Extensions, to Docker Desktop so one can benefit customers throughout all ranges.We’ll offer more details on these at DockerCon22. Watch this space.
To make use of latest kernel features