# Installation

## Preparation

First, be sure to meet all hardware and software [requirements](broken://pages/i2YVsRqOHhzqig2d0OaJ).

The Linux user installing beLow must be allowed to access Docker engine through the CLI (for full installation, server only or runner only in Dockerized mode). For this, follow Docker's [Linux post-installation steps for Docker Engine](https://docs.docker.com/engine/install/linux-postinstall/).

After a classical Docker installation on Ubuntu, the following commands should do the trick:

```sh
# Add current user to Docker group
sudo usermod -aG docker $USER
# Trick to avoid to perform a logout/login cycle (only works in current terminal)
newgrp docker
```

## Get installer

You can get the latest Linux package for your distribution from WedoLow's sales.

## Installation

{% hint style="warning" %}
Docker engine must be running during installation.
{% endhint %}

In a terminal, go to the folder of the package you downloaded (let's call it `beLow.xxx`). Then run:

{% tabs %}
{% tab title="Ubuntu" %}

```sh
sudo apt install ./beLow.deb
```

or

```sh
sudo dpkg -i ./beLow.deb
# If installation fails due to dependency, run the following command
sudo apt install -f
```

{% endtab %}

{% tab title="RHEL" %}

```sh
yum --nogpgcheck localinstall ./beLow.rpm
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
Installing using the .deb or .rpm package requires an internet connection to retrieve package dependencies. If your installation is offline, you will find the packages to be pre-installed below.
{% endhint %}

Package dependencies:

{% tabs %}
{% tab title="Ubuntu" %}

<table><thead><tr><th width="158">Distribution</th><th>Dependencies</th></tr></thead><tbody><tr><td>Ubuntu 20.04</td><td>libayatana-appindicator3-1<br>libfuse2<br>libspdlog1<br>libgrpc++1</td></tr><tr><td>Ubuntu 22.04</td><td>libayatana-appindicator3-1<br>libfuse2<br>libspdlog1<br>libgrpc++1</td></tr><tr><td>Ubuntu 24.04</td><td>libayatana-appindicator3-1<br>libfuse2<br>libspdlog1.12<br>libgrpc++1.51t64</td></tr></tbody></table>
{% endtab %}

{% tab title="RHEL" %}
No non-native dependency is needed, the package is self-sufficient.
{% endtab %}
{% endtabs %}

If beLow suite is successfully installed, you now have access to the following desktop applications:

* beLow
* beLowCTL
* beLowCTL - Headless (RHEL only)

<figure><img src="/files/vS1wftAcLKnM8AXVu5pl" alt=""><figcaption><p>beLow apps</p></figcaption></figure>

## Removal

For a complete removal of beLow, run the following command:

{% tabs %}
{% tab title="Ubuntu" %}

```sh
sudo apt autoremove below
```

{% endtab %}

{% tab title="RHEL" %}

```sh
sudo yum remove beLow
```

{% endtab %}
{% endtabs %}

## Offline

You must have a zip file containing the required docker images. This file is provided by Wedolow.

1. Do the installation as explained before
2. Run the following commands:

```bash
cd /tmp && unzip docker-images-export.zip
belowctl-headless docker-images import --input /tmp/docker-images-export
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.wedolow.com/documentation/below/installation-guide/installation-instructions/linux/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.