PFS103 - pfSense Alias Not Found

Agent error code #PFS103 indicates that the alias name configured in the Knocknoc ACL does not exist on pfSense. The agent looked the alias up and pfSense reported that no alias by that name is defined.

This error is distinct from update failures (#PFS102), which occur on aliases that exist but cannot be edited. Error #PFS103 means the alias is missing entirely.

Common causes include:

• The alias has not been created on pfSense yet, and the Aliases: Import privilege is missing so Knocknoc cannot auto-create it (see #PFS101)
• The alias name in the Knocknoc ACL has a typo (alias names are case-sensitive)
• The alias was renamed or deleted on pfSense after the Knoc was configured
• The API user lacks privilege to see the alias

Steps to Resolve

Verify the Alias Exists on pfSense

1. Log into pfSense and navigate to Firewall > Aliases > IP
2. Confirm an alias exists with the exact name configured in the Knocknoc ACL
3. Alias names are case-sensitive and must match exactly

Create the Alias

If the alias does not exist, create it:

1. Navigate to Firewall > Aliases > IP and click Add
2. Set Name to match the value in the Knocknoc ACL
3. Set Type to Host(s)
4. Leave the address list empty (Knocknoc populates it on first grant)
5. Click Save and Apply Changes

For the full setup, see the pfSense setup guide.

Verify the Alias Name in the Knocknoc ACL

1. In the Knocknoc admin interface, edit the affected Knoc's ACL
2. Confirm the Alias name value matches the alias on pfSense character-for-character

Still Having Issues?

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