mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-01 15:56:49 +00:00
33 lines
1.1 KiB
Markdown
33 lines
1.1 KiB
Markdown
---
|
|
layout: page
|
|
title: "Nmap support"
|
|
description: "Instructions how to integrate Nmap into Home Assistant."
|
|
date: 2015-03-23 19:59
|
|
sidebar: false
|
|
comments: false
|
|
sharing: true
|
|
footer: true
|
|
---
|
|
|
|
<img src='/images/supported_brands/network-workgroup.png' class='brand pull-right' />
|
|
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 nmap will not
|
|
scan this device, assuming it is home, in order to preserve the device battery.
|
|
|
|
See the [device tracker component page](/components/device_tracker.html) for instructions how to
|
|
configure the people to be tracked.
|