diff --git a/installation/linux/ubuntu.md b/installation/linux/ubuntu.md index 8310bdf33..11ad94cdd 100644 --- a/installation/linux/ubuntu.md +++ b/installation/linux/ubuntu.md @@ -1,11 +1,12 @@ # 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 @@ -13,12 +14,15 @@ 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: +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 @@ -26,7 +30,9 @@ curl https://packages.fluentbit.io/fluentbit.key | gpg --dearmor > /usr/share/ke ### 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: @@ -35,7 +41,8 @@ C3C0 A285 34B9 293E AF51 FABD 9F9D DC08 3888 C1CD Fluentbit releases (Releases signing key) ``` -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: @@ -43,11 +50,15 @@ 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](../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 @@ -55,33 +66,38 @@ deb [signed-by=/usr/share/keyrings/fluentbit-keyring.gpg] https://packages.fluen ### 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: @@ -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.