home-assistant.io/source/_components/device_tracker.luci.markdown
Lorenz Schmid d6dcc1b8a2 Added documentation for SSL option for OpenWRT(luci) (#5430)
* Added documentation for SSL option for OpenWRT(luci)

* Configuration sample should be minimal
2018-05-26 22:47:23 +02:00

1.8 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release
layout title description date sidebar comments sharing footer logo ha_category ha_release
page OpenWRT (luci) Instructions on how to integrate OpenWRT routers into Home Assistant. 2015-03-23 19:59 true false true true openwrt.png Presence Detection pre 0.7

This is one of multiple ways we support OpenWRT. For an overview, see openwrt.

This is a presence detection scanner for OpenWRT using luci.

This component requires a [workaround](https://github.com/home-assistant/home-assistant/issues/1258#issuecomment-252469880) when using luci with HTTPS and a self-signed certificate.

Before this scanner can be used you have to install the luci RPC package on OpenWRT:

# opkg install luci-mod-rpc

To use this device tracker in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
device_tracker:
  - platform: luci
    host: ROUTER_IP_ADDRESS
    username: YOUR_ADMIN_USERNAME
    password: YOUR_ADMIN_PASSWORD

Configuration variables:

  • host (Required): The IP address of your router, e.g., 192.168.1.1.
  • username (Required): The username of an user with administrative privileges, usually admin.
  • password (Required): The password for your given admin account.
  • ssl (Optional): If your router enforces SSL connections, set to true. Defaults to false.

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

Some installations have [a small bug](https://github.com/openwrt/luci/issues/576). The timeout for luci RPC calls is not set and this makes the call fail.