docs/desktop/linux/install/fedora.md

2.9 KiB

description keywords title toc_max
Instructions for installing Docker Desktop on Fedora requirements, apt, installation, fedora, rpm, install, uninstall, upgrade, update Install Docker Desktop on Fedora 4

To get started with Docker Desktop on Fedora, make sure you meet the prerequisites, then install Docker Desktop.

Prerequisites

Your Fedora distribution must meet the system requirements to install and launch Docker Desktop successfully.

Additionally, for a Gnome Desktop environment you must install AppIndicator and KStatusNotifierItem Gnome extensions.

OS requirements

To install Docker Desktop for Linux, you need the 64-bit version of one of these Fedora versions:

  • Fedora 35
  • Fedora 36

Install Docker Desktop

Recommended approach to install Docker Desktop on Ubuntu:

  1. Set up Docker's RPM repository

  2. Download latest RPM package from the release page.

  3. Install the package with dnf as follows:

$ sudo dnf install ./docker-desktop-<version>-<arch>.rpm

There are a few post-install configuration steps done through the maintainers' scripts (post-install script contained in the RPM package. The post-install script:

  • sets the capability on the Docker Desktop binary to map privileged ports and set resource limits
  • adds a DNS name for Kubernetes to /etc/hosts
  • creates a link from /usr/bin/docker to /usr/local/bin/com.docker.cli

Launch Docker Desktop

{% include desktop-linux-launch.md %}

Upgrade Docker Desktop

Once a new version for Docker Desktop is released, the Docker UI shows a notification. You need to first remove the previous version and then download the new package each time you want to upgrade Docker Desktop. Run:

$ sudo dnf remove docker-desktop
$ sudo dnf install ./docker-desktop-<version>-<arch>.rpm

Uninstall Docker Desktop

To remove Docker Desktop for Linux, run:

$ sudo dnf 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 systemd service files.

$ rm -r $HOME/.docker/desktop
$ sudo rm /usr/local/bin/com.docker.cli

Remove the credsStore and currentContext properties from $HOME/.docker/config.json. Additionally, you must delete any edited configuration files manually.

Next steps

  • Take a look at the Get started training modules to learn how to build an image and run it as a containerized application.
  • Review the topics in Develop with Docker to learn how to build new applications using Docker.