Skip to content

fedora.md

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 Instructions for installing Docker Desktop on Fedora
keywords fedora, rpm, update install, uninstall, upgrade, update, linux, desktop, docker desktop, docker desktop for linux, dd4l
title Install Docker Desktop on Fedora
toc_max 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.