Skip to content

Reflect podman 5.4 support in ECE doc #3748

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Nov 10, 2025
Merged

Reflect podman 5.4 support in ECE doc #3748

Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
2498700
Reflect podman 5.4 support in ECE doc
kunisen Oct 31, 2025
de257ba
Update configure-host-rhel.md
kunisen Oct 31, 2025
d29ebea
update to reflect the sync result with ECE dev
kunisen Nov 6, 2025
93dbbed
Apply suggestions from code review
shainaraskas Nov 10, 2025
fd8e61f
Merge branch 'main' into kunisen-docpr-stl-1669
shainaraskas Nov 10, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 7 additions & 7 deletions deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -100,26 +100,26 @@ Make sure to use a supported combination of Linux distribution and container eng

* For Podman 5

* Install the latest available version of Podman `5.2.2` using dnf.
* Install the latest available version of Podman `5.4` using dnf.

:::{note}
Podman versions `5.2.2-11` and `5.2.2-13` are affected by a known [memory leak issue](https://github.com/containers/podman/issues/25473). To avoid this bug, use a later build of `5.2.2`, such as `5.2.2-16` or newer. Refer to the official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) for more information.
Podman versions `5.2.2-11` and `5.2.2-13` are affected by a known [memory leak issue](https://github.com/containers/podman/issues/25473). To avoid this bug, use a later version. Refer to the official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) for more information.
:::

```sh
sudo dnf install podman-5.2.2 podman-remote-5.2.2
sudo dnf install podman-5.4.* podman-remote-5.4.*
Copy link

@Kushmaro Kushmaro Nov 3, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is it correct technically to specify the dnf command install like this?

Copy link
Contributor

@jakommo jakommo Nov 3, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yes, dnf supports wildcards and I did a quick test on rocky9 to confirm:

sh-5.1# dnf install podman-5.4.* podman-remote-5.4.*
Rocky Linux 9 - BaseOS                                                                                                                                                                                                                                                                                                2.4 MB/s | 2.5 MB     00:01    
Rocky Linux 9 - AppStream                                                                                                                                                                                                                                                                                             8.1 MB/s | 9.5 MB     00:01    
Rocky Linux 9 - Extras                                                                                                                                                                                                                                                                                                 43 kB/s |  17 kB     00:00    
Dependencies resolved.
======================================================================================================================================================================================================================================================================================================================================================
 Package                                                                                  Architecture                                                             Version                                                                                          Repository                                                                   Size
======================================================================================================================================================================================================================================================================================================================================================
Installing:
 podman                                                                                   x86_64                                                                   5:5.4.0-13.el9_6                                                                                 appstream                                                                    17 M
 podman-remote                                                                            x86_64                                                                   5:5.4.0-13.el9_6                                                                                 appstream                                                                    11 M
Installing dependencies:

Copy link
Contributor Author

@kunisen kunisen Nov 6, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi folks, as you also noticed the discussion with Matt, we could use a wilder scope of 5.x here to install the podman 5 latest version. As of writing, 5.4, result is the same, but the new command is more aligned to what we support.

Details in below comment:
#3748 (comment)

```
* To prevent automatic Podman updates to unsupported versions, configure the Podman version to be locked at version `5.2.2`.
* To prevent automatic Podman updates to unsupported versions, configure the Podman version to be locked at version `5.4.*`.

```sh
## Install versionlock
sudo dnf install 'dnf-command(versionlock)'

## Lock major version
sudo dnf versionlock add --raw 'podman-5.2.2'
sudo dnf versionlock add --raw 'podman-remote-5.2.2'
sudo dnf versionlock add --raw 'podman-5.4.*'
sudo dnf versionlock add --raw 'podman-remote-5.4.*'

## Verify that podman-5.2.2 and podman-remote-5.2.2 appear in the output
## Verify that podman-5.4.* and podman-remote-5.4.* appear in the output
sudo dnf versionlock list
```

Expand Down
14 changes: 7 additions & 7 deletions deploy-manage/deploy/cloud-enterprise/migrate-ece-to-podman-hosts.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -129,27 +129,27 @@ Using Docker or Podman as container runtime is a configuration local to the host

* For Podman 5

* Install the latest available version of Podman `5.2.2` using dnf.
* Install the latest available version of Podman `5.4` using dnf.

:::{note}
Podman versions `5.2.2-11` and `5.2.2-13` are affected by a known [memory leak issue](https://github.com/containers/podman/issues/25473). To avoid this bug, use a later build of `5.2.2`, such as `5.2.2-16` or newer. Refer to the official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) for more information.
Podman versions `5.2.2-11` and `5.2.2-13` are affected by a known [memory leak issue](https://github.com/containers/podman/issues/25473). To avoid this bug, use a later version. Refer to the official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) for more information.
:::

```sh
sudo dnf install podman-5.2.2 podman-remote-5.2.2
sudo dnf install podman-5.4.* podman-remote-5.4.*
```

* To prevent automatic Podman updates to unsupported versions, configure the Podman version to be locked at version `5.2.2`.
* To prevent automatic Podman updates to unsupported versions, configure the Podman version to be locked at version `5.4.*`.

```sh
## Install versionlock
sudo dnf install 'dnf-command(versionlock)'

## Lock major version
sudo dnf versionlock add --raw 'podman-5.2.2'
sudo dnf versionlock add --raw 'podman-remote-5.2.2'
sudo dnf versionlock add --raw 'podman-5.4.*'
sudo dnf versionlock add --raw 'podman-remote-5.4.*'

## Verify that podman-5.2.2 and podman-remote-5.2.2 appear in the output
## Verify that podman-5.4.* and podman-remote-5.4.* appear in the output
sudo dnf versionlock list
```

Expand Down
20 changes: 10 additions & 10 deletions deploy-manage/deploy/cloud-enterprise/migrate-to-podman-5.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,21 +13,21 @@ This guide describes the supported ways to upgrade or migrate your {{ece}} (ECE)

* **Grow-and-shrink upgrade**: [Add new hosts](./install-ece-on-additional-hosts.md) running the desired Podman version to your ECE installation, then [remove the old ones](/deploy-manage/uninstall/uninstall-elastic-cloud-enterprise.md). This method is safer and preferred, as it avoids potential risks associated with upgrading the container engine or the operating system in place.

ECE only supports Podman 5 in version `5.2.2`, regardless of your upgrade method. Later versions such as `5.2.3` and above are not supported. Refer always to the official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) for details on supported versions.
ECE supports Podman 5 in version `5.4`, regardless of your upgrade method. Refer always to the official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) for details on supported versions.

:::{important}
Podman versions `5.2.2-11` and `5.2.2-13` are affected by a known [memory leak issue](https://github.com/containers/podman/issues/25473). To avoid this issue, use a later build such as `5.2.2-16` or newer.
Podman versions `5.2.2-11` and `5.2.2-13` are affected by a known [memory leak issue](https://github.com/containers/podman/issues/25473). To avoid this issue, use a later podman version.
:::

The following table summarizes the supported upgrade paths to Podman 5 in ECE.

| **From ↓** ... **To →** | Podman 5.2.2-latest | Podman 5.2.3 |
|-----------------------------------------|-----------------|--------------|
| **<vanilla Linux installation> (grow)** | ✓ | X |
| **Docker (grow-and-shrink)** | ✓ | X |
| **Podman 4.9.4 (grow-and-shrink)** | ✓ | X |
| **Podman 4.9.4 (in-place)** | ✓ | X |
| **Podman 5.2.2 (grow-and-shrink)** | ✓ | X |
| **Podman 5.2.2 (in-place)** | ✓ | X |
| **From ↓** ... **To →** | Podman 5.4 |
|-----------------------------------------|-----------------|
| **<vanilla Linux installation> (grow)** | ✓ |
| **Docker (grow-and-shrink)** | ✓ |
| **Podman 4.9.4 (grow-and-shrink)** | ✓ |
| **Podman 4.9.4 (in-place)** | ✓ |
| **Podman 5.2.2 (grow-and-shrink)** | ✓ |
| **Podman 5.2.2 (in-place)** | ✓ |

As shown in the table above, [migrations from Docker](./migrate-ece-to-podman-hosts.md) are only supported using the grow-and-shrink method.