Installation

This page describes how to install beLow solution step by step on Linux.

Preparation

First, be sure to meet all hardware and software requirements.

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.

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

# 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

Docker engine must be running during installation.

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

Ubuntu

sudo apt install ./beLow.deb

or

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

RHEL

yum --nogpgcheck localinstall ./beLow.rpm

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.

Package dependencies:

Ubuntu

Distribution	Dependencies
Ubuntu 20.04	libayatana-appindicator3-1 libfuse2 libspdlog1 libgrpc++1
Ubuntu 22.04	libayatana-appindicator3-1 libfuse2 libspdlog1 libgrpc++1
Ubuntu 24.04	libayatana-appindicator3-1 libfuse2 libspdlog1.12 libgrpc++1.51t64

RHEL

No non-native dependency is needed, the package is self-sufficient.

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

• beLow

• beLowCTL

• beLowCTL - Headless (RHEL only)

beLow apps

Removal

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

Ubuntu

sudo apt autoremove below

RHEL

sudo yum remove beLow

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:

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