Preparing the host

The commands given in this section assume the yum package manager. They apply similarly but may need adaptions when applying to other Linux flavors.

Pretty much all the commands need to be run as super user. For convenience, one may become root as:

$ sudo su -
$ whoami

That way, the sudo prefixing may be omitted.

Install Docker and docker-compose

To run BlueRange in a Docker container, you’ll first need to install Docker and docker-compose.

Install Docker

Please follow the official installation instructions on Docker Engine to install Docker on your server. On most Linux distributions Docker should be part of the repository.

Please make sure to follow the official installation instructions as some distributions come with fairly outdated docker software packages in their default repositories!

Make sure to start and enable the Docker service after installation, so it is available after a system reboot.

$ sudo systemctl start docker
$ sudo systemctl enable docker
Created symlink /etc/systemd/system/ → /usr/lib/systemd/system/docker.service.

To verify the installation run:

$ sudo docker --version
Docker version 20.10.5, build 55c4c88
$ sudo docker ps

The above prints the docker version and all running containers which should result in an empty list.

Install docker compose

In recent versions compose gets installed automatically alongside with docker. Depending on your environment one of two slightly different compose versions may be available.

To verify the installation run:

$ sudo docker compose version
Docker Compose version v2.6.0
$ sudo docker-compose version
docker-compose version 1.28.6, build 5db8d86f

The above prints the docker compose version. If so, please proceed installing Additional tooling below.

For server installation any of these two will do so that it is okay if either one of these commands succeeds.

In case both the above commands fail, please follow the official installation instructions at Install Docker Compose to install docker-compose on your server. Once you have installed Docker and docker-compose, continue with the steps below.

Again, most distributions have outdated docker software in their repositories so that following these external instructions is highly recommended. Please notice that compose installation requires running an externally downloaded script with root rights.

Typically explicit installation requires the package docker-compose-plugin. It can be installed using the package manager, e.g. by running sudo yum install docker-compose-plugin.

Additional tooling

Some tool installations below require the addition of the Enterprise repository:

$ sudo yum install epel-release
Total download size: 23 k
Installed size: 32 k
Is this ok [y/N]: y


For generating secure random passwords the pwgen tool is handy:

$ sudo yum install pwgen
Total download size: 31 k
Installed size: 46 k
Is this ok [y/N]: y
$ pwgen -snc 48 1

The tool generates random passwords.

Vi IMproved

During this installation some files will need to be edited manually.

If you are not familiar with vim please skip this and keep using the default editor.

If you are familiar with vim set it as default editor with these commands:

$ sudo yum install vim
Total download size: 7.8 M
Installed size: 30 M
Is this ok [y/N]: y
$ sudo update-alternatives --install /usr/bin/editor editor /usr/bin/vim 100
$ sudo editor --version
VIM - Vi IMproved 8.0 (2016 Sep 12, compiled Jun 18 2020 15:49:08)

This should report a Vi IMproved now.


Some server scripts are prepared online for use as part of this installation. For easy updates these files are obtained and maintained using git which is installed as shown:

$ sudo yum install git
Total download size: 21 M
Installed size: 80 M
Is this ok [y/N]: y
$ sudo git --version
git version 2.27.0

This should report a git version now.