Windows Agent

To install the Pro Custodibus agent on Windows, download the agent MSI file from this page. After you have downloaded this file, copy it to the host and run it.

Download

Version Installer File PGP Signature SHA256 Checksum

latest

procustodibus_agent-latest-win64.msi

.sig

.sha256

1.8.0

procustodibus_agent-1.8.0-win64.msi

.sig

.sha256

For the old Windows .exe installer, see this page.

Install

As the Administrator user for the Windows host, place the procustodibus.conf and procustodibus-setup.conf files in host’s C:Program Files\Pro Custodibus Agent\cnf directory:

> mkdir "C:Program Files\Pro Custodibus Agent\cnf"
> move procustodibus.conf "C:Program Files\Pro Custodibus Agent\cnf\."
> move procustodibus-setup.conf "C:Program Files\Pro Custodibus Agent\cnf\."

Then run the installer MSI file:

> procustodibus_agent-latest-win64.msi

This will install the agent, and start it running as a service.

Run

If you ran the installer before moving the procustodibus.conf and procustodibus-setup.conf files to host’s C:Program Files\Pro Custodibus Agent\cnf directory, move them now (as the Administrator user):

> move procustodibus.conf "C:Program Files\Pro Custodibus Agent\cnf\."
> move procustodibus-setup.conf "C:Program Files\Pro Custodibus Agent\cnf\."

Then, as the Administrator user, stop the agent, and start it again:

> sc stop ProCustodibusAgentService

SERVICE_NAME: ProCustodibusAgentService
        TYPE               : 10  WIN32_OWN_PROCESS
        STATE              : 1  STOPPED
        WIN32_EXIT_CODE    : 0  (0x0)
        SERVICE_EXIT_CODE  : 0  (0x0)
        CHECKPOINT         : 0x0
        WAIT_HINT          : 0x0

> sc start ProCustodibusAgentService

  SERVICE_NAME: ProCustodibusAgentService
          TYPE               : 10  WIN32_OWN_PROCESS
          STATE              : 2  START_PENDING
                                  (NOT_STOPPABLE, NOT_PAUSABLE, IGNORES_SHUTDOWN)
          WIN32_EXIT_CODE    : 0  (0x0)
          SERVICE_EXIT_CODE  : 0  (0x0)
          CHECKPOINT         : 0x0
          WAIT_HINT          : 0x7d0
          PID                : 1234
          FLAGS

Run the following command to verify that the agent started up successfully:

> sc query ProCustodibusAgentService

  SERVICE_NAME: ProCustodibusAgentService
          TYPE               : 10  WIN32_OWN_PROCESS
          STATE              : 4  RUNNING
                                  (STOPPABLE, NOT_PAUSABLE, IGNORES_SHUTDOWN)
          WIN32_EXIT_CODE    : 0  (0x0)
          SERVICE_EXIT_CODE  : 0  (0x0)
          CHECKPOINT         : 0x0
          WAIT_HINT          : 0x0

If the agent is running, this command output should contain STATE : 4 RUNNING. If, not check the agent’s main log file:

> notepad "C:\Program Files\Pro Custodibus Agent\log\stdout.log"

Next Steps

  1. Check the host’s main page in the app. The Agent panel should show the results of the agent’s latest ping.

  2. If the Agent panel simply reads Set Up Agent, or if the Interfaces panel doesn’t list the WireGuard interfaces you already have running on the host, check the Agent Troubleshooting page.

Upgrade

To upgrade the agent, download the latest version of the installer, and run it as the Administrator user on the host:

> procustodibus_agent-latest-win64.msi

This will stop the existing agent service, uninstall it, install the new version, and start the new version running as a service.

Uninstall

As the Administrator user for the Windows host, open the Settings app, navigate to the Apps section, find the Pro Custodibus Agent app, and select its Uninstall option.

This will stop the agent service and uninstall it. It will not affect any WireGuard services currently running on the host.

See Microsoft’s Uninstall or remove apps and programs in Windows article for more details.

Other Options

To run the installer without prompts, use Windows' msiexec tool:

> msiexec.exe /i procustodibus_agent-1.8.0-win64.msi /qn