docs: reorganized linux installation

* One page per installation method

Signed-off-by: Fabrice Flore-Thébault <ffloreth@redhat.com>
This commit is contained in:
Fabrice Flore-Thébault 2023-01-30 12:35:13 +01:00 committed by Florent BENOIT
parent 5ca8c65f9a
commit ddac5ffd86
4 changed files with 142 additions and 131 deletions

View file

@ -1,131 +0,0 @@
---
sidebar_position: 5
title: Linux
description: You can install Podman Desktop on Linux from Flathub, a Flatpak bundle, or a ZIP archive.
tags: [podman-desktop, installing, linux, flathub, flatpak]
keywords: [podman desktop, podman, containers, installing, installation, linux, flathub, flatpak]
---
# Installing Podman Desktop on Linux
You can install Podman Desktop from:
* [Flathub](#flathub)
* [A Flatpak bundle](#flatpak-bundle)
* [A compressed tar file](#archive)
## Installing Podman Desktop from Flathub {#flathub}
Consider installing the Podman Desktop from Flathub to have:
* One command installation
* Package updates
#### Prerequisites
* [Flatpak](https://flatpak.org/setup/)
* [Podman](https://podman.io/whatis.html) stable version
#### Procedure
1. Verify the Flathub repository is enabled, and add it if required:
```shell-session
$ flatpak remote-add --if-not-exists --user flathub https://flathub.org/repo/flathub.flatpakrepo
```
2. Install Podman Desktop from Flathub:
```shell-session
$ flatpak install --user flathub io.podman_desktop.PodmanDesktop
```
#### Verification
* Open Podman Desktop from a terminal:
```shell-session
$ flatpak run io.podman_desktop.PodmanDesktop
```
#### Update
* Update Podman Desktop from Flathub:
```shell-session
$ flatpak update --user io.podman_desktop.PodmanDesktop
```
#### Additional resources
* [Podman Desktop Flathub package](https://flathub.org/apps/details/io.podman_desktop.PodmanDesktop)
* [Using Flatpak](https://docs.flatpak.org/en/latest/using-flatpak.html)
#### Next steps
* [Getting started](../getting-started/getting-started)
## Installing Podman Desktop from a Flatpak bundle {#flatpak-bundle}
Consider installing a Flatpak bundle rather than Flathub when:
* You cannot use Flathub.
* You want to install an unreleased version.
#### Prerequisites
* [Flatpak](https://flatpak.org/setup/)
* [Podman](https://podman.io/whatis.html) stable version
#### Procedure
1. Download the Flatpak bundle to a `$HOME/Downloads/podman-desktop-<version>.flatpak` file from:
* [Downloads page](../../../downloads/linux)
* [Git repository release assets](https://github.com/containers/podman-desktop/releases)
2. Install Podman Desktop from the downloaded Flatpak bundle:
```shell-session
$ flatpak install --user $HOME/Downloads/podman-desktop-<version>.flatpak
```
#### Verification
* Open Podman Desktop from a terminal:
```shell-session
$ flatpak run io.podman_desktop.PodmanDesktop
```
#### Additional resources
* [Using Flatpak](https://docs.flatpak.org/en/latest/using-flatpak.html)
#### Next steps
* [Getting started](../getting-started/getting-started).
## Installing Podman Desktop from a compressed tar file {#archive}
Consider installing from an archive rather than from Flathub, or a Flatpak bundle when:
* You cannot use Flatpak.
* You install in a restricted environment.
#### Prerequisites
* [Podman](https://podman.io/whatis.html) stable version
#### Procedure
1. Download the
`podman-desktop-<version>.tar.gz` archive from the [Git repository release assets](https://github.com/containers/podman-desktop/releases).
2. Extract the content.
3. Go to the extracted directory.
4. Double-click on the `podman-desktop` executable file.
#### Next steps
* [Getting started](../getting-started/getting-started)

View file

@ -0,0 +1,63 @@
---
sidebar_position: 5
title: Linux
description: You can install Podman Desktop on Linux from Flathub, a Flatpak bundle, or a ZIP archive.
tags: [podman-desktop, installing, linux, flathub, flatpak]
keywords: [podman desktop, podman, containers, installing, installation, linux, flathub, flatpak]
---
# Installing Podman Desktop on Linux
Consider installing the Podman Desktop from Flathub to have:
* One command installation
* Package updates
Alternatively, you can install Podman Desktop from:
* [A Flatpak bundle](./linux-install/installing-podman-desktop-from-a-flatpak-bundle)
* [A compressed tar file](linux-install/installing-podman-desktop-from-a-compressed-tar-file)
#### Prerequisites
* [Flatpak](https://flatpak.org/setup/)
* [Podman](https://podman.io/whatis.html) stable version
#### Procedure
1. Verify the Flathub repository is enabled, and add it if required:
```shell-session
$ flatpak remote-add --if-not-exists --user flathub https://flathub.org/repo/flathub.flatpakrepo
```
2. Install Podman Desktop from Flathub:
```shell-session
$ flatpak install --user flathub io.podman_desktop.PodmanDesktop
```
#### Verification
* Open Podman Desktop from a terminal:
```shell-session
$ flatpak run io.podman_desktop.PodmanDesktop
```
#### Update
* Update Podman Desktop from Flathub:
```shell-session
$ flatpak update --user io.podman_desktop.PodmanDesktop
```
#### Additional resources
* [Podman Desktop Flathub package](https://flathub.org/apps/details/io.podman_desktop.PodmanDesktop)
* [Using Flatpak](https://docs.flatpak.org/en/latest/using-flatpak.html)
#### Next steps
* [Getting started](../getting-started/getting-started)

View file

@ -0,0 +1,30 @@
---
sidebar_position: 3
title: Installing from a compressed tar file
description: You can install Podman Desktop on Linux from a compressed tar file.
tags: [podman-desktop, installing, linux, restricted-environment]
keywords: [podman desktop, podman, containers, installing, installation, linux, restricted-environment]
---
# Installing Podman Desktop from a compressed tar file {#archive}
Consider installing from an archive rather than [from Flathub](../linux-install), or [from a Flatpak bundle](installing-podman-desktop-from-a-flatpak-bundle) when:
* You cannot use Flatpak.
* You install in a restricted environment.
#### Prerequisites
* [Podman](https://podman.io/whatis.html) stable version
#### Procedure
1. Download the
`podman-desktop-<version>.tar.gz` archive from the [Git repository release assets](https://github.com/containers/podman-desktop/releases).
2. Extract the content.
3. Go to the extracted directory.
4. Double-click on the `podman-desktop` executable file.
#### Next steps
* [Getting started](../getting-started/getting-started)

View file

@ -0,0 +1,49 @@
---
sidebar_position: 2
title: Installing from a Flatpak bundle
description: You can install Podman Desktop on Linux from a Flatpak bundle.
tags: [podman-desktop, installing, linux, flathub, flatpak]
keywords: [podman desktop, podman, containers, installing, installation, linux, flathub, flatpak]
---
# Installing Podman Desktop from a Flatpak bundle {#flatpak-bundle}
Consider installing a Flatpak bundle rather than [from Flathub](../linux-install) when:
* You cannot use Flathub.
* You want to install an unreleased version.
#### Prerequisites
* [Flatpak](https://flatpak.org/setup/)
* [Podman](https://podman.io/whatis.html) stable version
#### Procedure
1. Download the Flatpak bundle to a `$HOME/Downloads/podman-desktop-<version>.flatpak` file from:
* [Downloads page](../../../downloads/linux)
* [Git repository release assets](https://github.com/containers/podman-desktop/releases)
2. Install Podman Desktop from the downloaded Flatpak bundle:
```shell-session
$ flatpak install --user $HOME/Downloads/podman-desktop-<version>.flatpak
```
#### Verification
* Open Podman Desktop from a terminal:
```shell-session
$ flatpak run io.podman_desktop.PodmanDesktop
```
#### Additional resources
* [Using Flatpak](https://docs.flatpak.org/en/latest/using-flatpak.html)
#### Next steps
* [Getting started](../getting-started/getting-started).