Skip to content
Merged
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
76 changes: 47 additions & 29 deletions installation/linux/debian.md
Original file line number Diff line number Diff line change
@@ -1,35 +1,43 @@
# Debian

Fluent Bit is distributed as **fluent-bit** package and is available for the latest (and legacy) stable Debian systems: Bookworm and Bullseye.
Fluent Bit is distributed as the `fluent-bit` package and is available for the latest
stable CentOS system.

The following architectures are supported

* x86\_64
* aarch64 / arm64v8
- `x86_64`
- `aarch64`
- `arm64v8`

## 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.
Fluent Bit provides an installation script to use for most Linux targets.
This will always install the most recently released version.

```bash
```bash copy
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.
The recommended secure deployment approach is to follow the instructions below.
This is a convenience helper and should always be validated prior to use.
The recommended secure deployment approach is to use the following instructions:

## 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: <https://wiki.debian.org/DebianRepository/UseThirdParty#OpenPGP\_Key\_distribution>
The first step is to add the Fluent Bit server GPG key to your keyring to ensure
you can get the correct signed packages.

```bash
Follow the official
[Debian wiki guidance](https://wiki.debian.org/DebianRepository/UseThirdParty#OpenPGP_Key_distribution).

```bash copy
curl https://packages.fluentbit.io/fluentbit.key | gpg --dearmor > /usr/share/keyrings/fluentbit-keyring.gpg
```

### 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.key](https://packages.fluentbit.io/fluentbit.key) so ensure this new one is added.
For the 1.9.0 and 1.8.15 and later releases, the
[GPG key has been updated](https://packages.fluentbit.io/fluentbit.key). Ensure
this new one is added.

The GPG Key fingerprint of the new key is:

Expand All @@ -38,51 +46,59 @@ C3C0 A285 34B9 293E AF51 FABD 9F9D DC08 3888 C1CD
Fluentbit releases (Releases signing key) <[email protected]>
```

The previous key is still available at [https://packages.fluentbit.io/fluentbit-legacy.key](https://packages.fluentbit.io/fluentbit-legacy.key) and may be required to install previous versions.
The previous key is [still available](https://packages.fluentbit.io/fluentbit-legacy.key)
and might be required to install previous versions.

The GPG Key fingerprint of the old key is:

```text
F209 D876 2A60 CD49 E680 633B 4FF8 368B 6EA0 722A
```

Refer to the [supported platform documentation](../supported-platforms.md) to see which platforms are supported in each release.
Refer to the [supported platform documentation](../supported-platforms.md) to see
which platforms are supported in each release.

## 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 [Debian release name](https://wiki.debian.org/DebianReleases#Production\_Releases) (e.g. `bookworm` for Debian 12):
For Debian, you must add the Fluent Bit APT server entry to your sources lists.
Add the following content at bottom of your `/etc/apt/sources.list` file.

```bash
```bash copy
deb [signed-by=/usr/share/keyrings/fluentbit-keyring.gpg] https://packages.fluentbit.io/debian/${CODENAME} ${CODENAME} main
```

Replace _`CODENAME`_ with your specific
[Debian release name](https://wiki.debian.org/DebianReleases#Production\_Releases)
(for example: `bookworm` for Debian 12)

## Update your repositories database

Now let your system update the _apt_ database:
Update your system's `apt` database:

```bash
```bash copy
sudo apt-get update
```

{% hint style="info" %}
We recommend upgrading your system (`sudo apt-get upgrade`). This could avoid potential issues with expired certificates.
Fluent Bit recommends upgrading your system (`sudo apt-get upgrade`). This could
avoid potential issues with expired certificates.
{% endhint %}

## Install Fluent Bit

Using the following _apt-get_ command you are able now to install the latest _fluent-bit_:
1. Use the following `apt-get` command to install the latest Fluent Bit:

```bash
sudo apt-get install fluent-bit
```
```bash copy
sudo apt-get install fluent-bit
```

Now the following step is to instruct _systemd_ to enable the service:
1. Instruct `systemd` to enable the service:

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

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

```bash
sudo service fluent-bit status
Expand All @@ -98,4 +114,6 @@ sudo service fluent-bit status
...
```

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.
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.
Loading