PFS004 - pfSense Connection Timed Out

Agent error code #PFS004 indicates that a pfSense API call did not complete within the agent's timeout window. The connection was established but pfSense did not return a response in time.

This error is distinct from connection failures (#PFS000), which occur before any TCP connection is made. Error #PFS004 means pfSense was contactable but slow to respond.

Common causes include:

• pfSense is under heavy load and slow to handle API requests
• The pfRest package is processing a configuration apply that has not yet completed
• A network device between the agent and pfSense is rate-limiting or shaping traffic
• A backup or update is running on pfSense

Steps to Resolve

Confirm pfSense Is Responsive

1. From the agent host, run curl -v https://<pfsense-host>/api/v2/system/version and measure the response time
2. If the same request takes several seconds from the command line, pfSense itself is slow and the underlying cause needs investigation

Check the pfSense System Status

1. Log into pfSense and check Status > Dashboard for CPU, memory, and disk load
2. Look for ongoing operations (package updates, backups, configuration applies) that might be blocking the API

Retry the Operation

1. Grants are idempotent. Retry by logging the affected user in again
2. If the timeout persists, escalate using the agent log detail

Still Having Issues?

We can help you out, contact us at support@knocknoc.io.