diff --git a/website/docs/Installation/linux-install.md b/website/docs/Installation/linux-install.md deleted file mode 100644 index 86c3506cbb3..00000000000 --- a/website/docs/Installation/linux-install.md +++ /dev/null @@ -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-.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-.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-.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) diff --git a/website/docs/Installation/linux-install/index.md b/website/docs/Installation/linux-install/index.md new file mode 100644 index 00000000000..dda5c26bcc5 --- /dev/null +++ b/website/docs/Installation/linux-install/index.md @@ -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) diff --git a/website/docs/Installation/linux-install/installing-podman-desktop-from-a-compressed-tar-file.md b/website/docs/Installation/linux-install/installing-podman-desktop-from-a-compressed-tar-file.md new file mode 100644 index 00000000000..b331529dc21 --- /dev/null +++ b/website/docs/Installation/linux-install/installing-podman-desktop-from-a-compressed-tar-file.md @@ -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-.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) diff --git a/website/docs/Installation/linux-install/installing-podman-desktop-from-a-flatpak-bundle.md b/website/docs/Installation/linux-install/installing-podman-desktop-from-a-flatpak-bundle.md new file mode 100644 index 00000000000..e6a818584d7 --- /dev/null +++ b/website/docs/Installation/linux-install/installing-podman-desktop-from-a-flatpak-bundle.md @@ -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-.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-.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).