Skip to content

installation: update to add Alma/Rocky Linux support #1708

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 1 commit into from
Jun 2, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
1 change: 1 addition & 0 deletions SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,7 @@
* [Build with Static Configuration](installation/sources/build-with-static-configuration.md)
* [Linux Packages](installation/linux/README.md)
* [Amazon Linux](installation/linux/amazon-linux.md)
* [Alma / Rocky Linux](installation/linux/alma-rocky.md)
* [Redhat / CentOS](installation/linux/redhat-centos.md)
* [Debian](installation/linux/debian.md)
* [Ubuntu](installation/linux/ubuntu.md)
Expand Down
84 changes: 84 additions & 0 deletions installation/linux/alma-rocky.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,84 @@
# Rocky Linux and Alma Linux

Fluent Bit is distributed as the `fluent-bit` package and is available for the latest
versions of Rocky or Alma Linux now that CentOS Stream is tracking more recent dependencies.

Fluent Bit supports the following architectures:

- `x86_64`
- `aarch64`
- `arm64v8`

## Single line install

Fluent Bit provides an installation script to use for most Linux targets.
This will always install the most recently released version.

```bash
curl https://raw.githubusercontent.com/fluent/fluent-bit/master/install.sh | sh
```

This is a convenience helper and should always be validated prior to use.
Older versions of this install script will not support auto-detecting Rocky or Alma Linux.
The recommended secure deployment approach is to use the following instructions:

## RHEL 9

From CentOS 9 Stream onwards, the CentOS dependencies will update more often than downstream usage.
This may mean that incompatible (more recent) versions are provided of certain dependencies (e.g. OpenSSL).
For OSS, we also provide RockyLinux and AlmaLinux repositories.
This may be required for RHEL 9 as well which will no longer track equivalent CentOS 9 stream dependencies.
No RHEL 9 build is provided, it is expected to use one of the OSS variants listed.

## Configure Yum

The `fluent-bit` is provided through a Yum repository.
To add the repository reference to your system:

1. In `/etc/yum.repos.d/`, add a new file called `fluent-bit.repo`.
1. Add the following content to the file - replace `almalinux` with `rockylinux` if required:

```text
[fluent-bit]
name = Fluent Bit
baseurl = https://packages.fluentbit.io/almalinux/$releasever/
gpgcheck=1
gpgkey=https://packages.fluentbit.io/fluentbit.key
repo_gpgcheck=1
enabled=1
```

1. As a best practice, enable `gpgcheck` and `repo_gpgcheck` for security reasons.
Fluent Bit signs its repository metadata and all Fluent Bit packages.

## Install

1. After your repository is configured, run the following command to install it:

```bash
sudo yum install fluent-bit
```

1. Instruct `Systemd` to enable the service:

```bash
sudo systemctl start fluent-bit
```

If you do a status check, you should see a similar output like this:

```bash
$ systemctl status fluent-bit
● fluent-bit.service - Fluent Bit
Loaded: loaded (/usr/lib/systemd/system/fluent-bit.service; disabled; vendor preset: disabled)
Active: active (running) since Thu 2016-07-07 02:08:01 BST; 9s ago
Main PID: 3820 (fluent-bit)
CGroup: /system.slice/fluent-bit.service
└─3820 /opt/fluent-bit/bin/fluent-bit -c etc/fluent-bit/fluent-bit.conf
...
```

The default Fluent Bit configuration collect metrics of CPU usage and sends the
records to the standard output. You can see the outgoing data in your
`/var/log/messages` file.

17 changes: 17 additions & 0 deletions installation/linux/redhat-centos.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,16 @@ sed -i 's|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g' /

An alternative is to use Rocky or Alma Linux, which should be equivalent.

## RHEL/AlmaLinux/RockyLinux and CentOS 9 Stream

From CentOS 9 Stream onwards, the CentOS dependencies will update more often than downstream usage.
This may mean that incompatible (more recent) versions are provided of certain dependencies (e.g. OpenSSL).
For OSS, we also provide RockyLinux and AlmaLinux repositories.

Replace the `centos` string in Yum configuration below with `almalinux` or `rockylinux` to use those repositories instead.
This may be required for RHEL 9 as well which will no longer track equivalent CentOS 9 stream dependencies.
No RHEL 9 build is provided, it is expected to use one of the OSS variants listed.

## Configure Yum

The `fluent-bit` is provided through a Yum repository. To add the repository
Expand Down Expand Up @@ -146,3 +156,10 @@ gpgkey=https://packages.fluentbit.io/fluentbit.key
repo_gpgcheck=1
enabled=1
```

### Yum install fails with incompatible dependencies using CentOS 9+

CentOS 9 onwards will no longer be compatible with RHEL 9 as it may track more recent dependencies.
Alternative AlmaLinux and RockyLinux repositories are available.

See the guidance above.
8 changes: 4 additions & 4 deletions installation/supported-platforms.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,10 +9,10 @@ Fluent Bit supports the following operating systems and architectures:
| | [CentOS 9 Stream](linux/redhat-centos.md) | x86_64, Arm64v8 |
| | [CentOS 8](linux/redhat-centos.md) | x86_64, Arm64v8 |
| | [CentOS 7](linux/redhat-centos.md) | x86_64, Arm64v8 |
| | [Rocky Linux 8](linux/redhat-centos.md) | x86_64, Arm64v8 |
| | [Rocky Linux 9](linux/redhat-centos.md) | x86_64, Arm64v8 |
| | [Alma Linux 8](linux/redhat-centos.md) | x86_64, Arm64v8 |
| | [Alma Linux 9](linux/redhat-centos.md) | x86_64, Arm64v8 |
| | [Rocky Linux 8](linux/alma-rocky.md) | x86_64, Arm64v8 |
| | [Rocky Linux 9](linux/alma-rocky.md) | x86_64, Arm64v8 |
| | [Alma Linux 8](linux/alma-rocky.md) | x86_64, Arm64v8 |
| | [Alma Linux 9](linux/alma-rocky.md) | x86_64, Arm64v8 |
| | [Debian 12 (Bookworm)](linux/debian.md) | x86_64, Arm64v8 |
| | [Debian 11 (Bullseye)](linux/debian.md) | x86_64, Arm64v8 |
| | [Debian 10 (Buster)](linux/debian.md) | x86_64, Arm64v8 |
Expand Down