Compare commits

...

5 commits

Author SHA1 Message Date
pboy
f35c7ab264 Merge #785 Add docker and docker-compose installation information 2024-11-14 06:43:14 +00:00
pboy
4e4cc61960 Merge #782 Update info for f41: Installing plugins for playing movies and music 2024-11-14 06:37:23 +00:00
Bradley G Smith
9152ca906b
Add docker and docker-compose installation information
Docker and docker-compose rpms have changed in Fedora 41 in ways that
may be confusing. This document identifies the rpms that comprise the
docker stack and describes some of the changes. Instructions are
provided to achieve common outcomes. RPM names are compared to the names
provided directly by the Docker community. Supplement information on
Podman is also provided.
2024-11-13 11:52:35 -08:00
Artem Polishchuk
054408ada0 Update info for f41: Installing plugins for playing movies and music 2024-11-09 18:10:56 +00:00
Dmitry Konishchev
772b84e2e6 Fix a typo in link spec 2024-11-08 09:06:32 +03:00
4 changed files with 216 additions and 1 deletions

View file

@ -66,6 +66,7 @@
** xref:debug-systemd-problems.adoc[How to debug systemd problems]
** xref:enable-touchpad-click.adoc[How to enable touchpad click]
** xref:installing-and-running-vlc.adoc[Installing and running the VLC player]
** xref:installing-docker.adoc[Installing Docker and Docker-Compose on Fedora]
** xref:jitsi-getting-started.adoc[Jitsi Meet Self-Hosting Guide]
** xref:mok-enrollment.adoc[Machine Owner Key Enrollment]
** xref:managing-keyboard-shortcuts-for-running-app-in-gnome.adoc[Managing keyboard shortcuts for running an application in GNOME]

View file

@ -0,0 +1,208 @@
= Installing Docker and Docker-Compose
Bradley G Smith,
:revnumber: F40,F41,rawhide
:revdate: 2024-11-13
:category: Installation
:tags: How-to, docker, docker-compose, dnf, rpm, containers
// Optional free form useful additional information as comment
//include::{partialsdir}/3rdparty-message.adoc[]
include::partial$3rdparty-message.adoc[]
[[sect-overview]]
== Overview
This guide provides useful information about installing link:https://www.docker.com/[Docker] and Docker-Compose using rpms available from Fedora.
The role of Podman and related packages is also discussed.
The Docker community also provides rpms for Fedora. For instructions on how to install these rpms please see link:https://docs.docker.com/engine/install/fedora/[Install Docker Engine on Fedora].
[[sect-what-is-docker]]
=== What is Docker?
link:https:/docker.io[Docker] accelerates "how you build, share, and run applications" by providing an easy to use and configure mechanism to develop and run containers.
This guide is primarily focused on the Docker rpms available from Fedora and using `dnf` and the command line to install these rpms on Fedora.
[[sect-what-is-docker-compose]]
=== What is Docker-Compose?
link:https://docs.docker.com/compose/[Docker-Compose] (referred to as Compose below) is software that enables users to easily manage multi-container applications or multiple applications on a single instance of Docker.
Version 1 of Compose was deployed as a stand-alone application called `docker-compose`.
Version 2 (the current version) is available as a plug-in to the `docker` command and launched as `docker compose [options]`.
[[sect-fedora-41]]
== Docker on Fedora 41 (and newer)
The Docker related rpms in Fedora 41 and newer are listed in the table below.
The corresponding rpm names from the Docker community are also listed for comparison.
Mixing rpms from Docker with Fedora provided rpms is not recommended and may be blocked by `dnf`.
.Docker rpms in Fedora 41 (and newer) compared to rpms from Docker community.
[cols="1,1,1", options="header"]
|===
|Fedora RPM Name|Docker RPM Name|Notes
|containerd
|containerd
|Container runtime
|docker-buildx
|docker-buildx-plugin
|Docker buildx plug-in
|docker-cli
|docker-ce-cli
|Docker command line client, i.e. `docker`
|docker-compose
|docker-compose-plugin
|Compose v2 implemented as a plug-in
|docker-compose-switch
|n/a - See link:https://github.com/docker/compose-switch[compose-switch] for installation instructions
|Provides command line `docker-compose` that works with Compose v2
|moby-engine
|docker-ce
|Server component for Docker
|===
=== Installation
In order to get `docker` on the command line, use the command below.
This will also install appropriate dependencies.
[source,bash]
----
sudo dnf install docker-cli containerd
----
In order to get Compose as a plug-in use the command below.
This will also install appropriate dependencies.
This provides Compose v2 features and capabilities.
[source,bash]
----
sudo dnf install docker-compose
----
In order to get `docker-compose` on the command line, use the command below.
This will also install appropriate dependencies.
This provides Compose v2 features and capabilities.
[source,bash]
----
sudo dnf install docker-switch
----
=== Podman Alternatives
link:https://podman.io/[Podman] is a powerful and feature complete application that can be used instead of Docker.
The instructions below are limited to only those that provide the `docker` and/or `docker-compose` commands.
Please visit link:https://podman.io/[Podman] to learn more about Podman capabilities and benefits.
In order to get `docker` on the command line, use the command below.
This will also install appropriate dependencies.
This will conflict with `docker-cli`.
[source,bash]
----
sudo dnf install podman-docker
----
In order to get Compose as a plug-in use the command below.
This will also install appropriate dependencies.
This provides Compose v2 features and capabilities.
[source,bash]
----
sudo dnf install podman docker-compose
----
In order to get `docker-compose` on the command line, use the command below.
This will also install appropriate dependencies.
This provides Compose v2 features and capabilities.
[source,bash]
----
sudo dnf install podman docker-switch
----
[[sect-fedora-40]]
== Fedora 40
The Docker related rpms in Fedora 40 are listed in the table below.
The corresponding rpm names from the Docker community are also listed for comparison.
Mixing rpms from Docker with Fedora provided rpms is not recommended and may be blocked by `dnf`.
.Docker rpms in Fedora 40 compared to rpms from Docker community.
[cols="1,1,1", options="header"]
|===
|Fedora RPM Name|Docker RPM Name|Notes
|containerd
|containerd
|Container runtime
|n/a
|docker-buildx-plugin
|Docker buildx plug-in
|docker-cli
|docker-ce-cli
|Docker command line client, i.e. `docker`
|docker-compose
|docker-compose
|Compose v1
|moby-engine
|docker-ce
|Server component for Docker
|===
=== Installation
In order to get `docker` on the command line, use the command below.
This will also install appropriate dependencies.
[source,bash]
----
sudo dnf install docker-cli containerd
----
In order to get `docker-compose` on the command line, use the command below.
This will also install appropriate dependencies.
This provides Compose v1 features and capabilities.
[source,bash]
----
sudo dnf install docker-compose
----
=== Podman Alternatives
link:https://podman.io/[Podman] is a powerful and feature complete application that can be used instead of Docker.
The instructions below are limited to only those that provide the `docker` and/or `docker-compose` commands.
Please visit link:https://podman.io/[Podman] to learn more about Podman capabilities and benefits.
In order to get `docker` on the command line, use the command below.
This will also install appropriate dependencies.
This will conflict with `docker-cli`.
[source,bash]
----
sudo dnf install podman-docker
----
In order to get `docker-compose` on the command line, use the command below.
This will also install appropriate dependencies.
This provides Compose v1 features and capabilities.
[source,bash]
----
sudo dnf install podman docker-compose
----

View file

@ -16,3 +16,9 @@ As a Fedora user and system administrator, you can use these steps to install ad
----
sudo dnf group install Multimedia
----
* For f41 and newer:
+
----
sudo dnf group install multimedia
----

View file

@ -59,7 +59,7 @@ $ *rpm -q _package_name_*
.Procedure
. If your system has SELinux disabled at the kernel level (this is the recommended way, see xref:changing-selinux-states-and-modes.adoc#_disabling_selinux[[]), change this first. Check if you have the `selinux=0` option in your kernel command line:
. If your system has SELinux disabled at the kernel level (this is the recommended way, see xref:changing-selinux-states-and-modes.adoc#_disabling_selinux[]), change this first. Check if you have the `selinux=0` option in your kernel command line:
+
[subs="quotes"]
----