Before installing the solution it is necessary to configure the timezone of your instance:

sudo timedatectl set-timezone Europe/Paris

Install Docker Runtime

The usual docker repository is not compatible with Rocky Linux, Docker's CentOS repo has to be used instead.

To install the docker runtime you can execute these commands:

sudo dnf config-manager --add-repo=
sudo dnf update
sudo dnf install docker-ce docker-ce-cli --allowerasing
sudo systemctl enable docker
sudo chmod +x /etc/rc.d/rc.local

sudo gpasswd -a $(whoami) docker
sudo usermod -aG docker $(whoami)

For more information on the installation of docker pleaser refer to the official documentation:

Creating Users are Required Directories

It is recommended to create a set of system users and groups to install the brainwave CLI.

sudo groupadd --system brainwave
sudo useradd --system --gid brainwave --no-create-home brainwave

Create the following directories:

sudo mkdir -p /var/log/brainwave
sudo mkdir -p /var/lib/brainwave
sudo mkdir -p /etc/brainwave
sudo mkdir -p /usr/local/brainwave

Set the owner of the new directories:

sudo chown -R brainwave:brainwave /var/log/brainwave
sudo chown -R brainwave:brainwave /var/lib/brainwave
sudo chown -R brainwave:brainwave /etc/brainwave
sudo chown -R brainwave:brainwave /usr/local/brainwave

Set the permissions

sudo chmod ug+rwx -R /var/log/brainwave
sudo chmod ug+rwx -R /var/lib/brainwave
sudo chmod ug+rwx -R /etc/brainwave
sudo chmod ug+rwx -R /usr/local/brainwave

Download and Install Brainwave CLI

Download the Brainwave tools binary and its corresponding sha256 file to verify the download, from Brainwave's Gitea repository You can also use the following direct link:

Verify the download

echo "$(cat brainwave.sha256)  brainwave" | sha256sum --check


sudo mkdir -p /usr/local/bin
sudo cp brainwave /usr/local/bin/brainwave
sudo chown brainwave:brainwave /usr/local/bin/brainwave
sudo chmod ug+rx /usr/local/bin/brainwave

Add the current user to the brainwave group

sudo usermod -aG brainwave $USER
newgrp brainwave

Brainwave Registry

It is necessary to log into the docker registry for Brainwave to be able to pull the desired images:

docker login


To install the solution in server mode please use the following command:

brainwave install --project-name brainwave --server
brainwave pull

Initial configuration

Before starting the services, set up the hostname

brainwave config --hostname brainwave.local

TLS configuration (Optional)

To activate tls

brainwave config --tls

Before starting the service it is necessary to copy the certificate and the private key into the certificates folder

cp brainwave.local.key /etc/brainwave/certificates/  
cp brainwave.local.crt /etc/brainwave/certificates/  

Please refer to the following page for more information:

SSL configuration page

Starting the Services

brainwave start

Once installed navigate to the /config webpage to finalize the configuration. Please see here for more information.