home-assistant.io/source/components/device_tracker.nmap_scanner.markdown
2015-09-20 21:25:09 -04:00

1.2 KiB

layout, title, description, date, sidebar, comments, sharing, footer
layout title description date sidebar comments sharing footer
page Nmap support Instructions how to integrate Nmap into Home Assistant. 2015-03-23 19:59 false false true true
As an alternative to the router-based device tracking, it is possible to directly scan the network for devices by using Nmap. The IP addresses to scan can be specified in any format that Nmap understands, including the network-prefix notation (`192.168.1.1/24`) and the range notation (`192.168.1.1-255`).

If you're on Debian or Ubuntu, you might have to install the packages for arp and nmap. Do so by running apt-get install net-tools nmap.

# Example configuration.yaml entry
device_tracker:
  platform: nmap_tracker
  hosts: 192.168.1.1/24
  home_interval: 10

home_interval is an optional value set in minutes. This will be the number of minutes to exclude devices from a scan while they are home. This is useful for iOS users that are experiencing issues where thier iDevices drop off the network for periods in order to save battery life.

See the device tracker component page for instructions how to configure the people to be tracked.