ScanopyScanopy
Discovery

Overview

How Scanopy discovers hosts and services on your network.

Daemons scan your network to discover hosts and services, then report their findings to the server.

How Discovery Works

Each daemon runs a single discovery. Every run does two things unconditionally: it scans the subnets it has been given, and it reports back which subnets it has interfaces on.

Network scanning

Scanning IP addresses on the configured subnets is what finds hosts in the first place. It:

  • Detects open TCP and UDP ports
  • Identifies services via pattern matching
  • Performs reverse DNS lookups
  • Collects MAC addresses, on directly connected subnets only

The daemon can scan any subnet it can route to — if its host can reach an address, it can scan it. What differs is depth. On a subnet the daemon has an interface on, it gets Layer 2: MAC addresses via ARP, and every responsive host. On a remote subnet it is limited to Layer 3, finding only hosts with an open port. See Layer 2 vs Layer 3.

On very large interfaced subnets the daemon caps how many addresses it ARP scans, governed by the ARP Scan Cutoff scan setting.

What credentials add

Everything beyond ports, names and addresses comes from a credential. Each one unlocks a different source:

Container & Virtualization

  • Docker Discover Docker containers and the services they expose.
  • Podman Discover Podman containers and the services they expose.

Network Monitoring

  • SNMP Discover a host's interfaces, system details, and CDP/LLDP neighbors.

Network Controllers

  • UniFi Controller Discover UniFi-managed switches, access points and gateways, their ports, and the LLDP neighbors and uplinks the controller sees.

A host reached through more than one source is still one host — everything flows into the same ingestion and matching path, so a device a controller reports and the same device found by a subnet scan are recognized as one.

In this section

On this page