Set Up a Host

To start monitoring a host, make sure you have added a host entry for it in the app. You can view the list of all your existing hosts on the Hosts page.

Set Up Page

The host’s setup page will outline the steps needed to set up the host, and include links to the agent configuration and setup files needed to install the agent.

Follow these steps to go to the host’s setup page:

  1. Click the Hosts link in the app header.

  2. Find the host in the list, and click its name to view its main status page.

  3. Click the “gear” icon on the right side of the Agent panel to view the host’s setup page.

Configuration File

On the host’s setup page, click the procustodibus.conf link to download the agent configuration file. Copy this file to the following location on the host:

/etc/wireguard/procustodibus.conf

The configuration file contains the configuration settings the agent will use for this specific host.

On hosts that don’t have a /etc/wireguard/ directory (such as hosts running FreeBSD or macOS), copy the agent configuration and setup files instead to the directory used by the host for WireGuard configuration (such as the /usr/local/etc/wireguard/ or /opt/homebrew/etc/wireguard/ directories).

Setup File

On the host’s setup page, click the procustodibus-setup.conf link to download the agent setup file. Copy this file to the following location on the host:

/etc/wireguard/procustodibus-setup.conf

The setup file contains a one-time setup code that the agent will use to authenticate with the Pro Custodibus servers the first time it connects. The agent will delete the setup file after it uses it.

The one-time code in the setup file is good for three days. If the code already has been used or has expired, you can download a replacement setup file with a new one-time code by clicking the same procustodibus-setup.conf link again.

Credentials File

As part of the setup process, the agent will generate a unique Ed25519 keypair that it will use to authenticate with on subsequent connections (note this keypair is distinct from any X25519 keys your host uses for WireGuard). The agent will save this keypair to the following location on the host:

/etc/wireguard/procustodibus-credentials.conf

The configuration file and either the credentials file or the setup file must be present on the host in order for the agent to run.

Next Steps

Download the agent software and copy it to the host (or run the agent in a container).