Skip to content

Latest commit

 

History

History
84 lines (53 loc) · 2.82 KB

fedora.md

File metadata and controls

84 lines (53 loc) · 2.82 KB
description keywords title toc_max
Instructions for installing Docker Desktop on Fedora
fedora, rpm, update install, uninstall, upgrade, update, linux, desktop, docker desktop, docker desktop for linux, dd4l
Install Docker Desktop on Fedora
4

This page contains information on how to install, launch and upgrade Docker Desktop on a Fedora distribution.

Prerequisites

To install Docker Desktop successfully, you must:

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

For non-Gnome Desktop environments, gnome-terminal must be installed:

$ sudo dnf install gnome-terminal

Install Docker Desktop

To install Docker Desktop on Fedora:

  1. Set up Docker's package 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 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.