Manual installation

This is hard way, only to install basic part of okerr and only for experienced okerr admins/developers who want to work with okerr under the hood. Also, this is rather hints and checklist but not complete guide and it could be outdated.

In other words: use automatic install instead :)

Install required debian packages

sudo apt install python3-dev python3-venv dialog gcc libmariadb-dev-compat libadns1-dev libffi-dev libssl-dev libsasl2-modules redis-server redis-tools libadns1-dev mariadb-server rsyslog postfix cron rabbitmq-server

Configure redis socket

edit /etc/redis/redis.conf append:

unixsocket /var/run/redis/redis.sock
unixsocketperm 770

sudo systemctl restart redis

sudo usermod -a -G redis USER

Relogin now, or make sure you will work as user root (not secure) or user with group redis.

Configure RabbitMQ

edit /etc/rabbitmq/rabbitmq.config

    {rabbit, [
            {tcp_listeners, []},
            {ssl_listeners, [{'', 5671}]},
            {ssl_options, [
                {cacertfile,           "/etc/okerr/ssl/ca.pem"},
                {certfile,             "/etc/okerr/ssl/rabbitmq.pem"},
                {verify,               verify_peer},
                {fail_if_no_peer_cert, true}

systemctl restart rabbitmq-server

create vhost and user:

sudo rabbitmqctl add_vhost okerr
sudo rabbitmqctl add_user okerr okerr_default_password
sudo rabbitmqctl set_permissions -p okerr okerr ".*" ".*" ".*"

Create db user

mysql -u root

CREATE USER 'okerr'@'localhost' IDENTIFIED BY 'okerrpass';
GRANT ALL ON okerr.* TO 'okerr'@'localhost';

Create and activate venv

sudo mkdir /opt/venv/okerr
sudo chown USER /opt/venv/okerr
python3 -m venv /opt/venv/okerr/
. /opt/venv/okerr/bin/activate

Install python packages

pip3 install -r requirements.txt

Create okerr certificates

sudo mkdir -p /etc/okerr/ssl
cd ca
sudo ./ ca
sudo ./ client
sudo ./ client rabbitmq

Initialize database

./ migrate
./ dbadmin --reinit --really

./ profile --create USER@EXAMPLE.COM --pass PASSWORD --textid okerr
./ group --assign Admin --user USER@EXAMPLE.COM --infinite

Create local config (optional)

sudo mkdir /etc/okerr/conf.d
sudo vim /etc/okerr/conf.d/local.conf

enable DEBUG in local.conf:


Start mqsender (task manager)

./ -v 

Start sensor -v

Start Okerr UI development UI

./ runserver

Configure okerr-smtpd

cp contrib/etc/systemd/system/okerr-smtpd.service /etc/systemd/system/ Edit this file and replace %VENV% and %OKERR%.

/etc/postfix/transport : smtp:localhost:10025

/etc/postfix/ :

transport_maps = hash:/etc/postfix/transport
relay_domains =,

postmap transport