Skip to main content

206005 - pfSense REST API Package Not Installed

Agent error code #206005 indicates that the agent connected to pfSense successfully but the pfRest REST API package is not installed or not enabled. None of Knocknoc's alias operations work without it.

This error is distinct from connection or authentication failures because the underlying pfSense GUI is reachable; only the REST API endpoints are missing.

Common causes include:

  • The pfSense REST API package (pfRest) has not been installed
  • The package was installed but is currently disabled in System > API > Settings
  • A pfSense upgrade removed or broke the package
  • The package was uninstalled by another administrator

Steps to Resolve

Install the pfRest Package

  1. Log into pfSense as an administrator
  2. Navigate to System > Package Manager > Available Packages
  3. Search for pfSense-pkg-RESTAPI and click Install
  4. Wait for the installation to complete and confirm a new System > API menu appears

For the full setup, see the pfSense setup guide.

Confirm the Package Is Enabled

  1. Navigate to System > API > Settings
  2. Confirm the API is enabled and listening
  3. Test the API directly from the agent host: curl -k https://<pfsense-host>/api/v2/system/version

Verify the pfRest Version

  1. The agent expects a current version of pfRest. If pfRest is very old, upgrade it via System > Package Manager > Installed Packages
  2. After upgrading, retry the grant in Knocknoc