diff --git a/installation/linux/debian.md b/installation/linux/debian.md index a3246f4d8..d6e9e22f2 100644 --- a/installation/linux/debian.md +++ b/installation/linux/debian.md @@ -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: +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: @@ -38,7 +46,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: @@ -46,43 +55,50 @@ 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 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 @@ -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.