Linux

manually

Download with wget, create config file, start. Althoug not necessary, it is recommended to have means to automatically start Kumpel when the system starts. There are multiple ways to do this. This is described in this section

Download binary for Linux x86

DHCP server

Kumpel acts as a DHCP server so you just need to connect your miners to the network and you’re good to go! You can disable this in the config file if you already have a DHCP server running. If you want to use the built-in DHCP server, Kumpel needs the according privileges. The easiest way is to run it as root. For improved security it is recommended, to have a non-root user running Kumpel. For Kumpel to still be able to bind to the DHCP port, you need to explicitly allow it (you’ll need Linux kernel > 2.6.24)

setcap 'cap_net_bind_service=+ep' /usr/local/sbin/kumpel/kumpel

creating the config file

You need to create a config file within the Kumpel installation directory. This is explained in the Configuring Kumpel section.

Starting Kumpel on system start

We will describe 2 ways, to start Kumpel automatically once the system starts.

cron

The easiest and most compatible way is a cronjob

You need to edit the cron table of the user Kumpel will run under. Logged in as that user, do so like this:

crontab -e

In that crontab add the following line:

@reboot cd /path/to/kumpel/ && ./kumpel update

This crontab entry will start Kumpel on system start. The update flag makes Kumpel update itself and start afterwards. Should anything go wrong or Kumpel needs an update, you just need to reboot the machine.

systemd

systemd is the standard way, lots of Linux distributions handle services these days. For example Ubuntu, Debian, Fedora, RHEL, Arch and many more. Creating a service with systemd is a bit more advanced than creating a cronjob but still pretty straight forward.

Assuming you put the Kumpel binary into the directory /usr/local/sbin/kumpel/, created a user and group Kumpel that have the permssions to run the binary, a systemd unit file might look like this:

[Unit]
Description=Kumpel
After=network.target multi-user.target

[Service]
ExecStart=/usr/local/sbin/kumpel/kumpel update
Restart=always
User=root
Group=root
WorkingDirectory=/usr/local/sbin/kumpel/

[Install]
WantedBy=multi-user.target

Put this file in the /etc/systemd/system/ folder on your system, run

$ systemctl daemon-reload
$ systemctl enable kumpel

Now the steiger daemon will start on system boot and you’re able to start, restart and stop Kumpel with

$ systemctl start kumpel
$ systemctl restart kumpel
$ systemctl stop kumpel

For further details please refer to the Systemd unit man pages

Kumpel directory

A typical Kumpel directory contains the following files:

4.0K -rw-r--r-- 1 kumpel kumpel  484 Oct 22 13:35 kumpel.json
4.8M -rw-r--r-- 1 kumpel kumpel 4.8M Oct 26 16:24 error.log
195M -rwxrwx--- 1 kumpel kumpel 195M Sep 29 18:37 kumpel
4.0K drwxr-xr-x 2 kumpel kumpel 4.0K Oct 25 17:01 storage
4.0K drwxr-xr-x 2 kumpel kumpel 4.0K Oct 25 17:01 cache
4.8M -rw-r--r-- 1 kumpel kumpel 4.8M Oct 26 16:24 warn.log