arrow-left

All pages
gitbookPowered by GitBook
1 of 6

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Amazon Linux

hashtag
Install on Amazon Linux

Fluent Bit is distributed as fluent-bit package and is available for the latest Amazon Linux 2 and Amazon Linux 2023. The following architectures are supported

  • x86_64

  • aarch64 / arm64v8

hashtag
Single line install

A simple installation script is provided to be used for most Linux targets. This will always install the most recent version released.

This is purely a convenience helper and should always be validated prior to use. The recommended secure deployment approach is to follow the instructions below.

hashtag
Amazon Linux 2022

Amazon Linux 2022 was previously supported but is removed since it became GA Amazon Linux 2023

hashtag
Configure Yum

We provide fluent-bit through a Yum repository. In order to add the repository reference to your system, please add a new file called fluent-bit.repo in /etc/yum.repos.d/ with the following content:

hashtag
Amazon Linux 2

hashtag
Amazon Linux 2023

Note: we encourage you always enable the gpgcheck for security reasons. All our packages are signed.

hashtag
Updated key from March 2022

From the 1.9.0 and 1.8.15 releases please note that the GPG key has been updated at so ensure this new one is added.

The GPG Key fingerprint of the new key is:

The previous key is still available at and may be required to install previous versions.

The GPG Key fingerprint of the old key is:

Refer to the to see which platforms are supported in each release.

hashtag
Install

Once your repository is configured, run the following command to install it:

Now the following step is to instruct systemd to enable the service:

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

The default configuration of fluent-bit is collecting metrics of CPU usage and sending the records to the standard output, you can see the outgoing data in your /var/log/messages file.

https://packages.fluentbit.io/fluentbit.keyarrow-up-right
https://packages.fluentbit.io/fluentbit-legacy.keyarrow-up-right
supported platform documentation
curl https://raw.githubusercontent.com/fluent/fluent-bit/master/install.sh | sh
[fluent-bit]
name = Fluent Bit
baseurl = https://packages.fluentbit.io/amazonlinux/2/
gpgcheck=1
gpgkey=https://packages.fluentbit.io/fluentbit.key
enabled=1
[fluent-bit]
name = Fluent Bit
baseurl = https://packages.fluentbit.io/amazonlinux/2023/
gpgcheck=1
gpgkey=https://packages.fluentbit.io/fluentbit.key
enabled=1
C3C0 A285 34B9 293E AF51  FABD 9F9D DC08 3888 C1CD
Fluentbit releases (Releases signing key) <[email protected]>
F209 D876 2A60 CD49 E680 633B 4FF8 368B 6EA0 722A
sudo yum install fluent-bit
sudo systemctl start fluent-bit
$ 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
...

Linux Packages

The most secure option is to create the repositories according to the instructions for your specific OS.

A simple installation script is provided to be used for most Linux targets. This will by default install the most recent version released.

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

This is purely a convenience helper and should always be validated prior to use.

hashtag
GPG key updates

From the 1.9.0 and 1.8.15 releases please note that the GPG key has been updated at so ensure this new one is added.

The GPG Key fingerprint of the new key is:

The previous key is still available at and may be required to install previous versions.

The GPG Key fingerprint of the old key is:

Refer to the to see which platforms are supported in each release.

hashtag
Migration to Fluent Bit

From version 1.9, td-agent-bit is a deprecated package and is removed after 1.9.9. The correct package name to use now is fluent-bit.

C3C0 A285 34B9 293E AF51  FABD 9F9D DC08 3888 C1CD
Fluentbit releases (Releases signing key) <[email protected]>
https://packages.fluentbit.io/fluentbit.keyarrow-up-right
https://packages.fluentbit.io/fluentbit-legacy.keyarrow-up-right
supported platform documentation
F209 D876 2A60 CD49 E680 633B 4FF8 368B 6EA0 722A

Debian

Fluent Bit is distributed as fluent-bit package and is available for the latest (and legacy) stable Debian systems: Bookworm and Bullseye. The following architectures are supported

  • x86_64

  • aarch64 / arm64v8

hashtag
Single line install

A simple installation script is provided to be used for most Linux targets. This will always install the most recent version released.

This is purely a convenience helper and should always be validated prior to use. The recommended secure deployment approach is to follow the instructions below.

hashtag
Server GPG key

The first step is to add our server GPG key to your keyring, on that way you can get our signed packages. Follow the official Debian wiki guidance:

hashtag
Updated key from March 2022

From the 1.9.0 and 1.8.15 releases please note that the GPG key has been updated at so ensure this new one is added.

The GPG Key fingerprint of the new key is:

The previous key is still available at and may be required to install previous versions.

The GPG Key fingerprint of the old key is:

Refer to the to see which platforms are supported in each release.

hashtag
Update your sources lists

On Debian, you need to add our APT server entry to your sources lists, please add the following content at bottom of your /etc/apt/sources.list file - ensure to set CODENAME to your specific (e.g. bookworm for Debian 12):

hashtag
Update your repositories database

Now let your system update the apt database:

circle-info

We recommend upgrading your system (sudo apt-get upgrade). This could avoid potential issues with expired certificates.

hashtag
Install Fluent Bit

Using the following apt-get command you are able now to install the latest fluent-bit:

Now the following step is to instruct systemd to enable the service:

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

The default configuration of fluent-bit is collecting metrics of CPU usage and sending the records to the standard output, you can see the outgoing data in your /var/log/syslog file.

https://wiki.debian.org/DebianRepository/UseThirdParty#OpenPGP\_Key\_distributionarrow-up-right
https://packages.fluentbit.io/fluentbit.keyarrow-up-right
https://packages.fluentbit.io/fluentbit-legacy.keyarrow-up-right
supported platform documentation
Debian release namearrow-up-right
curl https://raw.githubusercontent.com/fluent/fluent-bit/master/install.sh | sh
curl https://packages.fluentbit.io/fluentbit.key | gpg --dearmor > /usr/share/keyrings/fluentbit-keyring.gpg
C3C0 A285 34B9 293E AF51  FABD 9F9D DC08 3888 C1CD
Fluentbit releases (Releases signing key) <[email protected]>
F209 D876 2A60 CD49 E680 633B 4FF8 368B 6EA0 722A
deb [signed-by=/usr/share/keyrings/fluentbit-keyring.gpg] https://packages.fluentbit.io/debian/${CODENAME} ${CODENAME} main
sudo apt-get update
sudo apt-get install fluent-bit
sudo systemctl start fluent-bit
sudo service fluent-bit status
â—Ź fluent-bit.service - Fluent Bit
   Loaded: loaded (/lib/systemd/system/fluent-bit.service; disabled; vendor preset: enabled)
   Active: active (running) since mié 2016-07-06 16:58:25 CST; 2h 45min ago
 Main PID: 6739 (fluent-bit)
    Tasks: 1
   Memory: 656.0K
      CPU: 1.393s
   CGroup: /system.slice/fluent-bit.service
           └─6739 /opt/fluent-bit/bin/fluent-bit -c /etc/fluent-bit/fluent-bit.conf
...

Raspbian / Raspberry Pi

Fluent Bit is distributed as fluent-bit package and is available for the Raspberry, specifically for Raspbianarrow-up-right distribution, the following versions are supported:

  • Raspbian Bullseye (11)

  • Raspbian Buster (10)

hashtag
Server GPG key

The first step is to add our server GPG key to your keyring, on that way you can get our signed packages:

hashtag
Updated key from March 2022

From the 1.9.0 and 1.8.15 releases please note that the GPG key has been updated at so ensure this new one is added.

The GPG Key fingerprint of the new key is:

The previous key is still available at and may be required to install previous versions.

The GPG Key fingerprint of the old key is:

Refer to the to see which platforms are supported in each release.

hashtag
Update your sources lists

On Debian and derivative systems such as Raspbian, you need to add our APT server entry to your sources lists, please add the following content at bottom of your /etc/apt/sources.list file.

hashtag
Raspbian 11 (Bullseye)

hashtag
Raspbian 10 (Buster)

hashtag
Update your repositories database

Now let your system update the apt database:

circle-info

We recommend upgrading your system (sudo apt-get upgrade). This could avoid potential issues with expired certificates.

hashtag
Install Fluent Bit

Using the following apt-get command you are able now to install the latest fluent-bit:

Now the following step is to instruct systemd to enable the service:

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

The default configuration of fluent-bit is collecting metrics of CPU usage and sending the records to the standard output, you can see the outgoing data in your /var/log/syslog file.

Redhat / CentOS

hashtag
Install on Redhat / CentOS

Fluent Bit is distributed as fluent-bit package and is available for the latest stable CentOS system.

The following architectures are supported

https://packages.fluentbit.io/fluentbit.keyarrow-up-right
https://packages.fluentbit.io/fluentbit-legacy.keyarrow-up-right
supported platform documentation
x86_64
  • aarch64 / arm64v8

  • For CentOS 9+ we use CentOS Stream as the canonical base system.

    hashtag
    Single line install

    A simple installation script is provided to be used for most Linux targets. This will always install the most recent version released.

    This is purely a convenience helper and should always be validated prior to use. The recommended secure deployment approach is to follow the instructions below.

    hashtag
    CentOS 8

    CentOS 8 is now EOL so the default Yum repositories are unavailable.

    Make sure to configure to use an appropriate mirror, for example:

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

    hashtag
    Configure Yum

    We provide fluent-bit through a Yum repository. In order to add the repository reference to your system, please add a new file called fluent-bit.repo in /etc/yum.repos.d/ with the following content:

    It is best practice to always enable the gpgcheck and repo_gpgcheck for security reasons. We sign our repository metadata as well as all of our packages.

    hashtag
    Updated key from March 2022

    From the 1.9.0 and 1.8.15 releases please note that the GPG key has been updated at https://packages.fluentbit.io/fluentbit.keyarrow-up-right so ensure this new one is added.

    The GPG Key fingerprint of the new key is:

    The previous key is still available at https://packages.fluentbit.io/fluentbit-legacy.keyarrow-up-right and may be required to install previous versions.

    The GPG Key fingerprint of the old key is:

    Refer to the supported platform documentation to see which platforms are supported in each release.

    hashtag
    Install

    Once your repository is configured, run the following command to install it:

    Now the following step is to instruct Systemd to enable the service:

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

    The default configuration of fluent-bit is collecting metrics of CPU usage and sending the records to the standard output, you can see the outgoing data in your /var/log/messages file.

    hashtag
    FAQ

    hashtag
    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:

    Depending on your Red Hat distribution version, this variable may return a value other than the OS major release version (e.g., RHEL7 Server distributions return "7Server" instead of just "7"). The Fluent-Bit package url uses just the major OS release version, so any other value here will cause a 404.

    In order to resolve this issue, you can replace the $releasever variable with your system's OS major release version. For example:

    curl https://packages.fluentbit.io/fluentbit.key | sudo apt-key add -
    C3C0 A285 34B9 293E AF51  FABD 9F9D DC08 3888 C1CD
    Fluentbit releases (Releases signing key) <[email protected]>
    F209 D876 2A60 CD49 E680 633B 4FF8 368B 6EA0 722A
    deb https://packages.fluentbit.io/raspbian/bullseye bullseye main
    deb https://packages.fluentbit.io/raspbian/buster buster main
    sudo apt-get update
    sudo apt-get install fluent-bit
    sudo service fluent-bit start
    sudo service fluent-bit status
    â—Ź fluent-bit.service - Fluent Bit
       Loaded: loaded (/lib/systemd/system/fluent-bit.service; disabled; vendor preset: enabled)
       Active: active (running) since mié 2016-07-06 16:58:25 CST; 2h 45min ago
     Main PID: 6739 (fluent-bit)
        Tasks: 1
       Memory: 656.0K
          CPU: 1.393s
       CGroup: /system.slice/fluent-bit.service
               └─6739 /opt/fluent-bit/bin/fluent-bit -c /etc/fluent-bit/fluent-bit.conf
    ...
    curl https://raw.githubusercontent.com/fluent/fluent-bit/master/install.sh | sh
    $ 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-*
    [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
    C3C0 A285 34B9 293E AF51  FABD 9F9D DC08 3888 C1CD
    Fluentbit releases (Releases signing key) <[email protected]>
    F209 D876 2A60 CD49 E680 633B 4FF8 368B 6EA0 722A
    sudo yum install fluent-bit
    sudo systemctl start fluent-bit
    $ 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
    ...
    [fluent-bit]
    name = Fluent Bit
    baseurl = https://packages.fluentbit.io/centos/$releasever/$basearch/
    ...
    [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

    Ubuntu

    Fluent Bit is distributed as fluent-bit package and is available for long-term support releases of Ubuntu. The latest officially supported version is Noble Numbat (24.04).

    hashtag
    Single line install

    A simple installation script is provided to be used for most Linux targets. This will always install the most recent version released.

    This is purely a convenience helper and should always be validated prior to use. The recommended secure deployment approach is to follow the instructions below.

    hashtag
    Server GPG key

    The first step is to add our server GPG key to your keyring to ensure you can get our signed packages. Follow the official Debian wiki guidance:

    hashtag
    Updated key from March 2022

    From the 1.9.0 and 1.8.15 releases please note that the GPG key has been updated at so ensure this new one is added.

    The GPG Key fingerprint of the new key is:

    The previous key is still available at and may be required to install previous versions.

    The GPG Key fingerprint of the old key is:

    Refer to the to see which platforms are supported in each release.

    hashtag
    Update your sources lists

    On Ubuntu, you need to add our APT server entry to your sources lists, please add the following content at bottom of your /etc/apt/sources.list file - ensure to set CODENAME to your specific (e.g. focal for Ubuntu 20.04):

    hashtag
    Update your repositories database

    Now let your system update the apt database:

    circle-info

    We recommend upgrading your system (sudo apt-get upgrade). This could avoid potential issues with expired certificates.

    circle-info

    If you have the following error "Certificate verification failed", you might want to check if the package ca-certificates is properly installed (sudo apt-get install ca-certificates).

    hashtag
    Install Fluent Bit

    Using the following apt-get command you are able now to install the latest fluent-bit:

    Now the following step is to instruct systemd to enable the service:

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

    The default configuration of fluent-bit is collecting metrics of CPU usage and sending the records to the standard output, you can see the outgoing data in your /var/log/syslog file.

    curl https://raw.githubusercontent.com/fluent/fluent-bit/master/install.sh | sh
    https://wiki.debian.org/DebianRepository/UseThirdParty#OpenPGP\_Key\_distributionarrow-up-right
    https://packages.fluentbit.io/fluentbit.keyarrow-up-right
    https://packages.fluentbit.io/fluentbit-legacy.keyarrow-up-right
    supported platform documentation
    Ubuntu release namearrow-up-right
    curl https://packages.fluentbit.io/fluentbit.key | gpg --dearmor > /usr/share/keyrings/fluentbit-keyring.gpg
    C3C0 A285 34B9 293E AF51  FABD 9F9D DC08 3888 C1CD
    Fluentbit releases (Releases signing key) <[email protected]>
    F209 D876 2A60 CD49 E680 633B 4FF8 368B 6EA0 722A
    deb [signed-by=/usr/share/keyrings/fluentbit-keyring.gpg] https://packages.fluentbit.io/ubuntu/${CODENAME} ${CODENAME} main
    sudo apt-get update
    sudo apt-get install fluent-bit
    sudo systemctl start fluent-bit
    systemctl status fluent-bit
    â—Ź fluent-bit.service - Fluent Bit
       Loaded: loaded (/lib/systemd/system/fluent-bit.service; disabled; vendor preset: enabled)
       Active: active (running) since mié 2016-07-06 16:58:25 CST; 2h 45min ago
     Main PID: 6739 (fluent-bit)
        Tasks: 1
       Memory: 656.0K
          CPU: 1.393s
       CGroup: /system.slice/fluent-bit.service
               └─6739 /opt/fluent-bit/bin/fluent-bit -c /etc/fluent-bit/fluent-bit.conf
    ...