> For the complete documentation index, see [llms.txt](https://docs.blusapphire.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blusapphire.io/log-forwarding/03_log-forwarding-guide/log-forward/linux/linux-package-logshipper-installation.md).

# Linux Package (LogShipper) Installation

### Supported Systems

The deployment package supports **Debian-based Linux distributions** with the following requirements:

**System Requirements:**&#x20;

* **GLIBC Version:** Must be **2.28 or greater**

#### How to Check GLIBC Version

Run the following command in your terminal to verify the GLIBC version:

```bash
ldd --version
```

If the output shows a version below 2.28, you will need to update GLIBC or upgrade your system.

### Installation Steps

#### Follow these steps to install the BluLogShipper package on Debian-based systems:

1\. Log in to the portal and download the BluLogShipper Linux package (`blulogshipper_debian.zip`).

<figure><img src="/files/o1RbDDhRUu4xRsduMbAw" alt=""><figcaption></figcaption></figure>

2\. **Launch a Terminal** and navigate to the directory where the package was downloaded.&#x20;

Example: &#x20;

```bash
cd /path/to/downloads
```

<figure><img src="/files/f8Q1wmSuD1TvD3KXEJW1" alt=""><figcaption></figcaption></figure>

3. Extract the contents of the downloaded `.zip` file using the `unzip` command:

```bash
unzip *_linux_deb.zip  
```

<figure><img src="/files/80oF2TwTIED50LINpLi5" alt=""><figcaption></figcaption></figure>

If `unzip` command is not available, install using the command `sudo apt install unzip`

4\. Navigate to the extracted directory, use `chmod +x` command to make a file executable&#x20;

```bash
chmod +x install.sh
```

<figure><img src="/files/jbp6Wr0Iiv1tW2AL7d28" alt=""><figcaption></figcaption></figure>

5. Execute the installation script with superuser privileges to install the package:

```bash
sudo ./install.sh    
```

<figure><img src="/files/6LOGAYGztOIE16eN1z4p" alt=""><figcaption></figcaption></figure>

6. Verify the Installation

To ensure the package is installed correctly, verify that the service is running:

```bash
sudo systemctl status blulogshipper.service
```

<figure><img src="/files/XsfJoRcbBqWV66mSbnA8" alt=""><figcaption></figcaption></figure>

If the service is not active, you may start it using:

```bash
sudo systemctl start blulogshipper.service
```

{% embed url="<https://youtu.be/h9qbEhrZQts>" %}
