Pingtower Docs
Docs The addons agent portscan

portscan

Scan a host's ports and compare against a baseline. Needs nmap.

privileged Add portscan to agent.enable_addons. Needs the nmap binary on the box.

Parameters

ParameterDefaultMeaning
hostREQUIREDExactly one host.
portsREQUIREDPorts or ranges to scan, up to 1024.
baselineREQUIREDPorts expected open.
max_rate100/sCapped at 1000.
host_timeout60s

An open port not in the baseline is down. A baseline port proved closed is degraded. A port the scan could not determine is degraded.

Measurements

open_ports, unexpected_ports, missing_ports, undetermined_ports, scan_ms.

Scan only what you ownA port scan is a heavier network footprint than the other addons and is noticed by the target. Point it at your own hosts.
Last updated 1 Sep 2026 Report a problem with this page