# Ubuntu

Fluent Bit is distributed as **fluent-bit** package and is available for the latest stable Ubuntu system: Jammy Jellyfish.

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

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

## 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>

```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> so ensure this new one is added.

The GPG Key fingerprint of the new key is:

```
C3C0 A285 34B9 293E AF51  FABD 9F9D DC08 3888 C1CD
Fluentbit releases (Releases signing key) <releases@fluentbit.io>
```

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

The GPG Key fingerprint of the old key is:

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

Refer to the [supported platform documentation](https://docs.fluentbit.io/manual/2.0/installation/supported-platforms) 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):

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

```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 %}

{% 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`).
{% endhint %}

\## Install Fluent Bit

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

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

Now the following step is to 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
sudo service 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
...
```

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.