diun/docs/install/binary.md

Installation from binary

Download

Diun binaries are available on [releases]( config.repo_url releases) page.

Choose the archive matching the destination platform:

• [diun_ git.tag darwin_amd64.tar.gz]( config.repo_url /releases/download/v git.tag /diun git.tag _darwin_amd64.tar.gz)
• [diun_ git.tag darwin_arm64.tar.gz]( config.repo_url /releases/download/v git.tag /diun git.tag _darwin_arm64.tar.gz)
• [diun_ git.tag linux_386.tar.gz]( config.repo_url /releases/download/v git.tag /diun git.tag _linux_386.tar.gz)
• [diun_ git.tag linux_amd64.tar.gz]( config.repo_url /releases/download/v git.tag /diun git.tag _linux_amd64.tar.gz)
• [diun_ git.tag linux_arm64.tar.gz]( config.repo_url /releases/download/v git.tag /diun git.tag _linux_arm64.tar.gz)
• [diun_ git.tag linux_armv5.tar.gz]( config.repo_url /releases/download/v git.tag /diun git.tag _linux_armv5.tar.gz)
• [diun_ git.tag linux_armv6.tar.gz]( config.repo_url /releases/download/v git.tag /diun git.tag _linux_armv6.tar.gz)
• [diun_ git.tag linux_armv7.tar.gz]( config.repo_url /releases/download/v git.tag /diun git.tag _linux_armv7.tar.gz)
• [diun_ git.tag linux_ppc64le.tar.gz]( config.repo_url /releases/download/v git.tag /diun git.tag _linux_ppc64le.tar.gz)
• [diun_ git.tag linux_riscv64.tar.gz]( config.repo_url /releases/download/v git.tag /diun git.tag _linux_riscv64.tar.gz)
• [diun_ git.tag linux_s390x.tar.gz]( config.repo_url /releases/download/v git.tag /diun git.tag _linux_s390x.tar.gz)
• [diun_ git.tag windows_386.zip]( config.repo_url /releases/download/v git.tag /diun git.tag _windows_386.zip)
• [diun_ git.tag windows_amd64.zip]( config.repo_url /releases/download/v git.tag /diun git.tag _windows_amd64.zip)
• [diun_ git.tag windows_arm64.zip]( config.repo_url /releases/download/v git.tag /diun git.tag _windows_arm64.zip)

And extract diun:

wget -qO- [[ config.repo_url ]]releases/download/v[[ git.tag | trim('v') ]]/diun_[[ git.tag | trim('v') ]]_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.