Installation from binary¶

Download¶

Diun binaries are available on releases page.

Choose the archive matching the destination platform:

And extract diun:

wget -qO- https://github.com/crazy-max/diun/releases/download/v4.29.0-6-g8678b194/diun_4.29.0-6-g8678b194_linux_amd64.tar.gz | tar -zxvf - diun

After getting the binary, it can be tested with ./diun --help command and moved to a permanent location.

Server configuration¶

Steps below are the recommended server configuration.

Prepare environment¶

Create user to run diun (ex. diun)

groupadd diun
useradd -s /bin/false -d /bin/null -g diun diun

Create required directory structure¶

mkdir -p /var/lib/diun
chown diun:diun /var/lib/diun/
chmod -R 750 /var/lib/diun/
mkdir /etc/diun
chown diun:diun /etc/diun
chmod 770 /etc/diun

Configuration¶

Create your first configuration file in /etc/diun/diun.yml and type:

chown diun:diun /etc/diun/diun.yml
chmod 644 /etc/diun/diun.yml

Note

Not required if you want to only rely on environment variables

Copy binary to global location¶

cp diun /usr/local/bin/diun

Running Diun¶

After the above steps, two options to run Diun:

1. Creating a service file (recommended)¶

See how to create Linux service to start Diun automatically.

2. Running from terminal¶

DIUN_DB_PATH=/var/lib/diun/diun.db /usr/local/bin/diun serve --config /etc/diun/diun.yml

Updating to a new version¶

You can update to a new version of Diun by stopping it, replacing the binary at /usr/local/bin/diun and restarting the instance.

If you have carried out the installation steps as described above, the binary should have the generic name diun. Do not change this, i.e. to include the version number.

Last update: 2023-05-25 16:41:02
Created: 2020-06-19 22:47:17