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
66 changes: 42 additions & 24 deletions installation/linux/ubuntu.md
Original file line number Diff line number Diff line change
@@ -1,32 +1,38 @@
# 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).
Fluent Bit is distributed as the `fluent-bit` package and is available for long-term
support releases of Ubuntu. The latest officially supported version is Noble Numbat
(24.04).

## Single line install

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

```bash
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.
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 to ensure 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.

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

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

The GPG Key fingerprint of the new key is:

Expand All @@ -35,53 +41,63 @@ 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 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 [Ubuntu release name](https://wiki.ubuntu.com/Releases) (e.g. `focal` for Ubuntu 20.04):
On Ubuntu, you need to add the Fluent Bit APT server entry to your sources lists.
Add the following content at bottom of your `/etc/apt/sources.list` file. Ensure
`CODENAME` is set to your specific [Ubuntu release name](https://wiki.ubuntu.com/Releases).
For example, `focal` for Ubuntu 20.04.

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

### Update your repositories database

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

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

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

{% hint style="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`).
`sudo apt-get upgrade`


If you receive the error `Certificate verification failed`, check if the package
`ca-certificates` is properly installed:

`sudo apt-get install ca-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:

```text
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:

Expand All @@ -99,4 +115,6 @@ systemctl status fluent-bit
...
```

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