Skip to content

Run Jibril as a Systemd Service

Jibril can be run as a systemd service.

This is the recommended way to run Jibril in staging/production environments. The following steps will guide you through the installation and configuration of Jibril as a systemd service.

Install the Service

To install the service, run:

sudo -E jibril --systemd install

This command will create:

  1. /etc/systemd/system/jibril.service
  2. /etc/jibril/config.yaml
  3. /etc/jibril/netpolicy.yaml

The systemd service will be installed, but not enabled yet.

Edit the Configuration File

Edit the configuration file at /etc/jibril/config.yaml. The default configuration enables Jibril with most of its plugins and the detection events.

The default configuration should be changed for production environments. It is recommended to fine-tune the configuration files to enable only the necessary plugins, printers and events.

Enable the Service

After editing the configuration file, enable the service by running:

sudo -E jibril --systemd enable-now

This will enable the service to start at boot time AND start the service immediately.

Check the Service Status

To check the status of the service, run:

sudo systemctl status jibril

Check the Logs

The varlog printer is enabled by default in the configuration file. This means that the JSON events are printed to /var/log/jibril/events.log, while Jibril stdout and stderr are redirected to systemd journal.

To check the logs, run:

sudo journalctl -u jibril

and to check the events, run:

sudo cat /var/log/jibril/events.log | jq

Disable the Service

God forbid, but if you need to disable the service, run:

sudo -E jibril --systemd disable-now

This will disable the service from starting at boot time AND stop the service immediately.