Installing Fisher

If you want to use Fisher in a new machine you need to install it. Fisher is written in Rust, and it's available as a single binary you can drop into your path.

Unfortunately, no precompiled packages for any Linux distribution are available yet. In the future they might become available.

Precompiled binaries

Official precompiled binaries are available from files.pietroalbini.org. You can download the latest version from it and extract the binary contained in it in your ${PATH} (usually /usr/local/bin). There are also GPG signatures available if you want to check them.

Install from source

If you want to build Fisher from source, you need to have the Rust 1.17 (or greater) toolchain installed on the target machine. Keep in mind this might take a while to complete.

The easiest way to build from source is to build the package uploaded in the Rust's package registry, crates.io:

$ cargo install fisher

Instead, if you want to compile directly from the source code you need to fetch the code from the git repository, and then build it with Cargo.

$ git clone https://github.com/pietroalbini/fisher
$ cd fisher
$ cargo build --release

The binary will be available in target/release/fisher.

Starting Fisher at boot time

If you want to start Fisher at boot, you should create a new systemd service (if your distribution uses systemd as the init). Place the following file in /etc/systemd/system/fisher.service:

[Unit]
Description=The Fisher webhooks catcher

[Service]
ExecStart=/usr/local/bin/fisher /srv/webhooks/config.toml
ExecReload=/bin/kill -USR1 $MAINPID

User=fisher
Group=fisher

PrivateTmp=yes

[Install]
WantedBy=multi-user.target

This service assumes your system is configured this way:

  • The Fisher binary is located in /usr/local/bin/fisher
  • The configuration file is located in /srv/webhooks/config.toml
  • Fisher is executed by the fisher user

If those things don't match your server configuration, you must change them in the service file. Then, you can manage Fisher like every other systemd service:

$ systemctl start fisher
$ systemctl stop fisher
$ systemctl restart fisher
$ systemctl reload fisher
$ systemctl status fisher