Troubleshooting Scans
Overview
Troubleshooting issues triggered by running scans, including network load, missing hosts, and scan performance.
Issues triggered by running scans, including network load, missing hosts, and scan performance.
Host Discovery
Hosts missing from discovery results — ARP issues, switch rate limiting (DAI), Npcap, and tuning.
Scan Performance
Scans crashing targets, taking hours, failing from high concurrency, or hitting file descriptor limits.
Credentials
Credential file read failures, PEM errors, and credentials loading successfully but failing authentication on target devices.
Topology Empty After Discovery
Symptoms: Discovery completes but topology shows nothing
Check these:
- Discovery errors: Check Discover > Scan > Sessions for failures
- Network filter: Check topology options panel — wrong network may be selected
- Snapshot vs live view: Make sure the view selector is on Live — a selected snapshot shows a past capture, not current discovery data
- Service filters: Category filters may be hiding everything
- Reachability: Verify daemon can actually reach the target network
Getting Help
If your issue isn't covered here:
- Discord: Join our Discord community
- GitHub Issues: Open an issue