Skip to content

Troubleshooting Checklist

Use this sequence before opening a support request.

1. Confirm known-good baseline

  • Exact version and architecture recorded
  • Issue reproduces consistently
  • No untracked recent config changes

2. Interface and route sanity

  • WAN/LAN assignment correct
  • WAN addressing and gateway valid
  • LAN subnet and DHCP behavior valid
  • Default route on WAN present

3. Firewall path checks (pf behavior)

  • Correct rule on correct interface
  • Rule order reflects intended match precedence
  • State creation visible for expected traffic
  • Logs show pass/block outcomes consistent with policy intent

4. NAT and service checks

  • Port forward target IP/port correct
  • Matching allow policy exists after translation
  • Service on target host is listening on expected port
  • External testing performed from outside local LAN path

5. DNS, IP Pool mapping, and time checks

  • Resolver returns expected answers
  • If using DNS forwarder IP pool mapping:
  • Domain mapping is configured in DNS forwarder
  • Queries are actually flowing through this firewall's DNS forwarder
  • Target IP Pool exists and is referenced by firewall rules
  • pf table contents reflect expected resolved addresses
  • NTP/time is accurate (critical for VPN/TLS)

6. VPN mode checks (when relevant)

  • IPsec: phase alignment, peer identifiers, subnet selectors
  • L2TP/IPsec: client pool, PSK, and user auth path
  • PPTP (legacy): TCP/1723 and GRE path plus user auth

7. Capture support evidence

  • Interface mapping screenshot/text
  • Relevant firewall/NAT/VPN pages
  • Logs around exact test timestamps
  • Repro steps and expected vs actual behavior

Common symptom guide

Symptom Primary areas to inspect
No Internet from LAN WAN route, DNS, firewall policy
Port forward fails NAT mapping + corresponding pass policy
VPN up, no traffic phase2 subnet scope, firewall policy, routing
DNS-name policy mismatch DNS forwarder mapping, IP Pool table contents, rule source/destination pool
Web UI unreachable interface assignment, LAN addressing, management policy