Skip to content

[ECE] Clarify supported Ubuntu version #1621

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.

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 9 commits into from
Jun 12, 2025
11 changes: 6 additions & 5 deletions deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,13 +12,10 @@ products:

# Configure a RHEL host [ece-configure-hosts-rhel-centos]



The following instructions show you how to prepare your hosts on Red Hat Enterprise Linux 8 (RHEL 8), 9 (RHEL 9), and Rocky Linux 8 and 9.

* [Prerequisites](#ece-prerequisites-rhel8)
* [Configure the host](#ece-configure-hosts-rhel8-podman)

* [Install Podman and configure the host](#ece-configure-hosts-rhel8-podman)

## Prerequisites [ece-prerequisites-rhel8]

Expand All @@ -28,7 +25,11 @@ Verify that required traffic is allowed. Check the [Networking prerequisites](ec

**Example:** For AWS, allowing traffic between hosts is implemented using security groups.

## Configure the host [ece-configure-hosts-rhel8-podman]
::::{important}
Make sure to use a supported combination of Linux distribution and container engine version as defined in our official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). Unsupported combinations can lead to various issues in your ECE environment, including failures when creating system deployments, upgrading workload deployments, proxy timeouts, and more.
::::

## Install Podman and configure the host [ece-configure-hosts-rhel8-podman]

1. Install the OS packages `lvm2`, `iptables`, `sysstat`, and `net-tools` by executing:

Expand Down
11 changes: 5 additions & 6 deletions deploy-manage/deploy/cloud-enterprise/configure-host-suse.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,10 +12,10 @@ products:

# Configure a SUSE host [ece-configure-hosts-sles12]

The following instructions show you how to prepare your hosts on SLES 12 SP5 or 15.
The following instructions explain how to prepare your hosts on SUSE Linux Enterprise Server 12 SP5 (SLES 12) or 15 (SLES 15).

* [Install Docker](#ece-install-docker-sles12)
* [Set up XFS on SLES](#ece-xfs-setup-sles12)
* [Set up XFS quotas](#ece-xfs-setup-sles12)
* [Update the configurations settings](#ece-update-config-sles)
* [Configure the Docker daemon options](#ece-configure-docker-daemon-sles12)

Expand All @@ -26,11 +26,10 @@ If you want to install {{ece}} (ECE) on your own hosts, the steps for preparing

Regardless of which approach you take, the steps in this section need to be performed on every host that you want to use with ECE.


## Install Docker [ece-install-docker-sles12]
## Install Docker on SLES [ece-install-docker-sles12]

::::{important}
Make sure to use a combination of Linux distribution and Docker version that is supported, following our official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). Using unsupported combinations can cause multiple issues with you ECE environment, such as failures to create system deployments, to upgrade workload deployments, proxy timeouts, and more.
Make sure to use a supported combination of Linux distribution and container engine version as defined in our official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). Unsupported combinations can lead to various issues in your ECE environment, including failures when creating system deployments, upgrading workload deployments, proxy timeouts, and more.
::::


Expand Down Expand Up @@ -87,7 +86,7 @@ Make sure to use a combination of Linux distribution and Docker version that is



## Set up XFS on SLES [ece-xfs-setup-sles12]
## Set up XFS quotas [ece-xfs-setup-sles12]

XFS is required to support disk space quotas for {{es}} data directories. Some Linux distributions such as RHEL and Rocky Linux already provide XFS as the default file system. On SLES 12 and 15, you need to set up an XFS file system and have quotas enabled.

Expand Down
19 changes: 7 additions & 12 deletions deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,25 +12,20 @@ products:

# Configure an Ubuntu host [ece-configure-hosts-ubuntu]

The following instructions show you how to prepare your hosts on 20.04 LTS (Focal Fossa) and Ubuntu 22.04 LTS (Jammy Jellyfish).
The following instructions show you how to prepare your hosts on Ubuntu.

* [Install Docker 24.0](#ece-install-docker-ubuntu)
* [Install Docker](#ece-install-docker-ubuntu)
* [Set up XFS quotas](#ece-xfs-setup-ubuntu)
* [Update the configurations settings](#ece-update-config-ubuntu)
* [Configure the Docker daemon options](#ece-configure-docker-daemon-ubuntu)


## Install Docker [ece-install-docker-ubuntu]
## Install Docker on Ubuntu [ece-install-docker-ubuntu]

Install Docker LTS version 24.0 for Ubuntu 20.04 or 22.04.
Install a compatible Docker version on Ubuntu.

::::{important}
Make sure to use a combination of Linux distribution and Docker version that is supported, following our official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). Using unsupported combinations can cause multiple issues with you ECE environment, such as failures to create system deployments, to upgrade workload deployments, proxy timeouts, and more.
::::


::::{note}
Docker 25 and higher are not compatible with ECE 3.7.
Make sure to use a supported combination of Linux distribution and container engine version as defined in our official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). Unsupported combinations can lead to various issues in your ECE environment, including failures when creating system deployments, upgrading workload deployments, proxy timeouts, and more.
::::


Expand All @@ -55,10 +50,10 @@ Docker 25 and higher are not compatible with ECE 3.7.
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
```

4. Install the correct version of the `docker-ce` package, for Ubuntu 20.04 LTS (Focal Fossa) or Ubuntu 22.04 LTS (Jammy Jellyfish):
4. Install the correct version of the `docker-ce` package. The following is an example of installing Docker 27.0. If you decide to install a different Docker version, make sure to replace with the desired version in the commands below.

```sh
sudo apt install -y docker-ce=5:24.0.* docker-ce-cli=5:24.0.* containerd.io
sudo apt install -y docker-ce=5:27.0.* docker-ce-cli=5:27.0.* containerd.io
```


Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,10 @@ products:

Before installing {{ece}}, you have to prepare your hosts with one of the following Linux distributions:

* [Ubuntu 20.04 LTS (Focal Fossa) and Ubuntu 22.04 LTS (Jammy Jellyfish)](configure-host-ubuntu.md)
* [Red Hat Enterprise Linux (RHEL) 8 and 9](configure-host-rhel.md)
* [Rocky Linux 8 and 9](configure-host-rhel.md)
* [SUSE Linux Enterprise Server (SLES) 12 SP5 and 15](configure-host-suse.md)
* [Ubuntu](configure-host-ubuntu.md)
* [Red Hat Enterprise Linux (RHEL) and Rocky Linux](configure-host-rhel.md)
* [SUSE Linux Enterprise Server (SLES)](configure-host-suse.md)

::::{important}
Make sure to use a supported combination of Linux distribution and container engine version, such as `Docker` or `Podman`, as defined in our official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). Unsupported combinations can lead to various issues in your ECE environment, including failures when creating system deployments, upgrading workload deployments, proxy timeouts, and more.
::::
Loading