OpenBSD Orchestration Agent

Install the Knocknoc orchestration agent on an OpenBSD host.

Install

Run this as root on the OpenBSD host you want Knocknoc to control. OpenBSD base has no bash or curl, so fetch the installer with ftp and pipe it to sh. The script installs the signed knocknoc-agent package, writes its config and enrols the host against your Knocknoc server.

ftp -o - https://packages.knocknoc.io/setup/setup_knocknoc_agent.sh | sh

Prefer to read the script before piping to sh? View it here.

What the script does

  1. Imports the Knocknoc signing key.
  2. Installs the knocknoc-agent package via pkg_add.
  3. Grants the orchestration agent the access it needs to manage pf.
  4. Enables and starts the orchestration agent as an rc.d service at boot.

You'll be prompted for the hostname of your Knocknoc server so the orchestration agent can enrol.

Supported releases

  • OpenBSD 7.x

Full installation and orchestration agent configuration: https://docs.knocknoc.io/books/admin-guide/page/openbsd-agent-installation.