dawarich/systemd/README.md

Installing dawarich with systemd

This guide is based on my experience setting up dawarich on Debian 12.

Prerequisites

Postgresql

You need a recent version of Postgresql with PostGIS support.

In Debian you can install it with

apt install postgresql-postgis

If you do not want to run the database on the same host as the dawarich service, you need to reconfigure Postgresql to allow connections from that host.

Dawarich will populate it's database itself and only needs a user account to do so. This account needs to have superuser capabilities as the database population includes enabling the postgis extention:

sudo -u postgres psql <<EOF
CREATE USER dawarich PASSWORD 'UseAStrongPasswordAndKeepItSecret';
ALTER USER dawarich WITH SUPERUSER;
EOF

Redis

Install a recent version of Redis.

In Debian you can install it with

apt install redis-server

If you do not want to run the redis service on the same host as the dawarich service, you need to reconfigure redis to accept connection from that host and most likely configure authentication.

System User account

Create an account that will run the ruby services of dawarich. Of course, you can choose another directory for it's HOME.

adduser --system --home /service/dawarich dawarich

Ruby

Dawarich currently uses Ruby version 3.4.1 (yes, exactly this one). At least on Debian, this version is not available at all in the package repositories. So I installed Ruby by compiling from source:

apt install build-essential pkg-config libpq-dev libffi-dev libyaml-dev zlib1g-dev

# compile & install as unprivileged user
sudo -u dawarich bash

# download
cd ~
mkdir src
cd src
wget https://cache.ruby-lang.org/pub/ruby/3.4/ruby-3.4.1.tar.gz

# unpack
tar -xzf ruby-3.4.1.tar.gz
cd ~/ruby-3.4.1

# build & install
./configure --prefix $HOME/ruby-3.4.1
make all test install

# allow easy replacement of used ruby installation
ln -s ruby-3.4.1 ~dawarich/ruby

exit # sudo -u dawarich bash

Install dawarich

0. Clone the repo to /service/dawarich/dawarich and install dependencies.

# install as unprivileged user
sudo -u dawarich bash

cd ~
git clone https://github.com/Freika/dawarich.git
cd dawarich

# install dependencies
bash systemd/install.sh

exit # sudo -u dawarich bash

0. Install, enable and start systemd services

# install systemd services
install systemd/dawarich.service systemd/dawarich-sidekiq.service /etc/systemd/system
systemctl daemon-reload
systemctl enable --now dawarich.service dawarich-sidekiq.service
systemctl status dawarich.service dawarich-sidekiq.service