Skip to content

packaging: add opensuse and sles #2103

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

Open
wants to merge 4 commits into
base: master
Choose a base branch
from
Open

packaging: add opensuse and sles #2103

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
7eaac33
packaging: add opensuse and sles
illescad Oct 16, 2025
7dc3b5e
packaging: fix suse.md
illescad Oct 16, 2025
76d762b
packaging: only use aarch64 as supported suse architecture to avoid c…
illescad Oct 17, 2025
0faeb29
Apply suggestions from code review
esmerel Oct 21, 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
1 change: 1 addition & 0 deletions SUMMARY.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@
* [Amazon Linux](installation/downloads/linux/amazon-linux.md)
* [Rocky Linux and Alma Linux ](installation/downloads/linux/alma-rocky.md)
* [Red Hat and CentOS](installation/downloads/linux/redhat-centos.md)
* [openSUSE / SLES](installation/downloads/linux/suse.md)

Check warning on line 31 in SUMMARY.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[FluentBit.Acronyms] Spell out 'SLES', if it's unfamiliar to the audience.

Raw Output:
{"message": "[FluentBit.Acronyms] Spell out 'SLES', if it's unfamiliar to the audience.", "location": {"path": "SUMMARY.md", "range": {"start": {"line": 31, "column": 19}}}, "severity": "INFO"}
* [Debian](installation/downloads/linux/debian.md)
* [Ubuntu](installation/downloads/linux/ubuntu.md)
* [Raspbian and Raspberry Pi](installation/downloads/linux/raspbian-raspberry-pi.md)
Expand Down
2 changes: 2 additions & 0 deletions installation/downloads.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,8 @@ Fluent Bit supports the following operating systems and architectures:
| macOS | * | x86_64, Apple M1 |
| Windows | [Windows Server 2019](downloads/windows.md) | x86_64, x86 |
| | [Windows 10 1903](downloads/windows.md) | x86_64, x86 |
| | [openSUSE Leap 15.6](downloads/linux/suse.md) | x86_64, Arm64v8 |
| | [SUSE Linux Enterprise Server (SLES) 15.7](downloads/linux/suse.md) | x86_64, Arm64v8 |

From an architecture support perspective, Fluent Bit is fully functional on x86_64, Arm64v8, and Arm32v7 based processors.

Expand Down
140 changes: 140 additions & 0 deletions installation/downloads/linux/suse.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,140 @@
# openSUSE and SLES

Check warning on line 1 in installation/downloads/linux/suse.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[FluentBit.Acronyms] Spell out 'SLES', if it's unfamiliar to the audience.

Raw Output:
{"message": "[FluentBit.Acronyms] Spell out 'SLES', if it's unfamiliar to the audience.", "location": {"path": "installation/downloads/linux/suse.md", "range": {"start": {"line": 1, "column": 16}}}, "severity": "INFO"}

Check warning on line 1 in installation/downloads/linux/suse.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[FluentBit.Headings] 'openSUSE and SLES' should use sentence-style capitalization.

Raw Output:
{"message": "[FluentBit.Headings] 'openSUSE and SLES' should use sentence-style capitalization.", "location": {"path": "installation/downloads/linux/suse.md", "range": {"start": {"line": 1, "column": 3}}}, "severity": "INFO"}

Fluent Bit is distributed as the `fluent-bit` package and is available for the latest stable opensuse-leap and sles 15.7 system.

Check warning on line 3 in installation/downloads/linux/suse.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[FluentBit.Spelling] Spelling check: 'sles'?

Raw Output:
{"message": "[FluentBit.Spelling] Spelling check: 'sles'?", "location": {"path": "installation/downloads/linux/suse.md", "range": {"start": {"line": 3, "column": 112}}}, "severity": "INFO"}

Fluent Bit supports the following architectures:

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

For openSUSE 15, Fluent Bit uses [openSUSE Leap](https://get.opensuse.org/leap) as the canonical base system.

The recommended secure deployment approach is to use the following instructions:

## For openSUSE and SUSE Linux Enterprise Server (SLES)

Check warning on line 15 in installation/downloads/linux/suse.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[FluentBit.Acronyms] Spell out 'SUSE', if it's unfamiliar to the audience.

Raw Output:
{"message": "[FluentBit.Acronyms] Spell out 'SUSE', if it's unfamiliar to the audience.", "location": {"path": "installation/downloads/linux/suse.md", "range": {"start": {"line": 15, "column": 21}}}, "severity": "INFO"}

Check warning on line 15 in installation/downloads/linux/suse.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[FluentBit.Headings] 'For openSUSE and SUSE Linux Enterprise Server (SLES)' should use sentence-style capitalization.

Raw Output:
{"message": "[FluentBit.Headings] 'For openSUSE and SUSE Linux Enterprise Server (SLES)' should use sentence-style capitalization.", "location": {"path": "installation/downloads/linux/suse.md", "range": {"start": {"line": 15, "column": 4}}}, "severity": "INFO"}

Fluent Bit provides packages for openSUSE (Leap) and SUSE Linux Enterprise Server (SLES). The repository uses the $releasever variable to dynamically fetch packages for your specific system version.

Check warning on line 17 in installation/downloads/linux/suse.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[FluentBit.Spelling] Spelling check: 'releasever'?

Raw Output:
{"message": "[FluentBit.Spelling] Spelling check: 'releasever'?", "location": {"path": "installation/downloads/linux/suse.md", "range": {"start": {"line": 17, "column": 116}}}, "severity": "INFO"}

Check warning on line 17 in installation/downloads/linux/suse.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[FluentBit.Acronyms] Spell out 'SUSE', if it's unfamiliar to the audience.

Raw Output:
{"message": "[FluentBit.Acronyms] Spell out 'SUSE', if it's unfamiliar to the audience.", "location": {"path": "installation/downloads/linux/suse.md", "range": {"start": {"line": 17, "column": 54}}}, "severity": "INFO"}

## Configure `zypper`

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

1. Import the GPG key used to sign the packages.
1. In `/etc/zypp/repos.d/`, add a new file named `fluent-bit.repo`.
1. Add the following content to the file.
```text
[fluent-bit]
name = Fluent Bit
baseurl = https://packages.fluentbit.io/suse/$releasever/
gpgcheck=1
gpgkey=https://packages.fluentbit.io/fluentbit.key
repo_gpgcheck=1
enabled=1
```
1. Refresh the repository to make the new packages available.
```text
sudo zypper refresh
```
1. As a best practice, gpgcheck and repo_gpgcheck are enabled by default for security reasons. Fluent Bit signs its repository metadata and all Fluent Bit packages

Check warning on line 39 in installation/downloads/linux/suse.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[FluentBit.Spelling] Spelling check: 'repo_gpgcheck'?

Raw Output:
{"message": "[FluentBit.Spelling] Spelling check: 'repo_gpgcheck'?", "location": {"path": "installation/downloads/linux/suse.md", "range": {"start": {"line": 39, "column": 37}}}, "severity": "INFO"}

Check warning on line 39 in installation/downloads/linux/suse.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[FluentBit.Spelling] Spelling check: 'gpgcheck'?

Raw Output:
{"message": "[FluentBit.Spelling] Spelling check: 'gpgcheck'?", "location": {"path": "installation/downloads/linux/suse.md", "range": {"start": {"line": 39, "column": 24}}}, "severity": "INFO"}

## Install

Ensure you've configured an appropriate mirror. For example:

```shell
$ sed -i 's/mirrorlist/#mirrorlist/g' /etc/yum.repos.d/CentOS-* && \

$ sed -i 's|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g' /etc/yum.repos.d/CentOS-*
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
$ sed -i 's/mirrorlist/#mirrorlist/g' /etc/yum.repos.d/CentOS-* && \
$ sed -i 's|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g' /etc/yum.repos.d/CentOS-*
sed -i 's/mirrorlist/#mirrorlist/g' /etc/yum.repos.d/CentOS-* && \
sed -i 's|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g' /etc/yum.repos.d/CentOS-*

```

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

## SLES

For openSUSE and SUSE Linux Enterprise Server (SLES)

Fluent Bit provides packages for openSUSE (Leap) and SUSE Linux Enterprise Server (SLES). The repository uses the $releasever variable to dynamically fetch packages for your specific system version.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Fluent Bit provides packages for openSUSE (Leap) and SUSE Linux Enterprise Server (SLES). The repository uses the $releasever variable to dynamically fetch packages for your specific system version.
Fluent Bit provides packages for openSUSE (Leap) and SUSE Linux Enterprise Server (SLES). The repository uses the `$releasever` variable to dynamically fetch packages for your specific system version.


## Configure `zypper`

The`fluent-bit` package 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:

```text
[fluent-bit]
name = Fluent Bit
baseurl = https://packages.fluentbit.io/centos/$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. Ensure your [GPG key](../linux.md#gpg-key-updates) is up to date.

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

```shell
sudo dnf install fluent-bit
```

1. Instruct `Systemd` to enable the service:

```shell
sudo systemctl start fluent-bit
```

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

```shell
$ 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.

## FAQ

### Yum install fails with a `404 - Page not found` error for the package mirror

The `fluent-bit.repo` file for the latest installations of Fluent Bit uses a `$releasever` variable to determine the correct version of the package to install to your system:

```text
[fluent-bit]
name = Fluent Bit
baseurl = https://packages.fluentbit.io/centos/$releasever/$basearch/
```

Depending on your Red Hat distribution version, this variable can return a value other than the OS major release version (for example, RHEL7 Server distributions return `7Server` instead of `7`). The Fluent Bit package URL uses the major OS release version, so any other value here will cause a 404.

To resolve this issue, replace the `$releasever` variable with your system's OS major release version. For example:

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

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

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

See the previous guidance.
2 changes: 2 additions & 0 deletions installation/getting-started-with-fluent-bit.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,8 @@ To select a package for a container or operating system, use the instructions fo
| Alma Linux / Red Hat | [Alma Linux 8](downloads/linux/alma-rocky.md), [Alma Linux 9](downloads/linux/alma-rocky.md), [Alma Linux 10](downloads/linux/alma-rocky.md) |
| CentOS / Red Hat | [CentOS 7](downloads/linux/redhat-centos.md#install-on-redhat-centos), [CentOS 8](downloads/linux/redhat-centos.md#install-on-redhat-centos), [CentOS 9 Stream](downloads/linux/redhat-centos.md#install-on-redhat-centos), [CentOS 10 Stream](downloads/linux/redhat-centos.md#install-on-redhat-centos) |
| Rocky Linux / Red Hat | [Rocky Linux 8](downloads/linux/alma-rocky.md), [Rocky Linux 9](downloads/linux/alma-rocky.md), [Rocky Linux 10](downloads/linux/alma-rocky.md) |
| openSUSE Leap | [openSUSE Leap 15.6](downloads/linux/suse.md) |
| SUSE Linux Enterprise | [SUSE Linux Enterprise Server 15.7](downloads/linux/suse.md) |
| Ubuntu | [Ubuntu 16.04 LTS](downloads/linux/ubuntu.md), [Ubuntu 18.04 LTS](downloads/linux/ubuntu.md), [Ubuntu 20.04 LTS](downloads/linux/ubuntu.md), [Ubuntu 22.04 LTS](downloads/linux/ubuntu.md), [Ubuntu 24.04 LTS](downloads/linux/ubuntu.md) |
| Debian | [Debian 10](downloads/linux/debian.md), [Debian 11](downloads/linux/debian.md), [Debian 12](downloads/linux/debian.md), [Debian 13](downloads/linux/debian.md) |
| Amazon Linux | [Amazon Linux 2](downloads/linux/amazon-linux.md#install-on-amazon-linux-2), [Amazon Linux 2023](downloads/linux/amazon-linux.md#amazon-linux-2023) |
Expand Down
Loading