The asuswrt integration is the main integration to connect to a ASUSWRT based router.

There is currently support for the following device types within Home Assistant:

  • Presence Detection - The ASUSWRT platform offers presence detection by looking at connected devices to a ASUSWRT based router.
  • Sensor - The ASUSWRT sensor platform allows you to get upload and download data from your ASUSWRT within Home Assistant.


To use an ASUSWRT router in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry

Configuration Variables

host string Required

The IP address of your router, e.g.,

username string Required

The username of a user with administrative privileges, usually admin.

password string (Optional)

The password for your given admin account (use this if no SSH key is given).

protocol string (Optional, default: ssh)

The protocol (ssh or telnet) to use.

port integer (Optional, default: 22)

SSH port to use.

mode string (Optional, default: router)

The operating mode of the router (router or ap).

ssh_key string (Optional)

The path to your SSH private key file associated with your given admin account (instead of password).

require_ip boolean (Optional, default: true)

If the router is in access point mode.

interface string (Optional, default: eth0)

The interface of the router that you want statistics from (e.g. eth0,eth1 etc)

dnsmasq string (Optional, default: /var/lib/misc)

The location of the dnsmasq.leases files

sensors list (Optional)

List of enabled sensors


Connected devices sensor


TX upload sensor


RX download sensor


download mbit/s sensor


upload mbit/s sensor

You need to enable telnet on your router if you choose to use protocol: telnet.

Example Sensor Configuration

To enable ASUSWRT sensors as part of your installation, reference the following example configuration:

# Example configuration.yaml entry
  ssh_key: /config/id_rsa
    - devices
    - upload
    - download
    - upload_speed
    - download_speed

The example above, creates the following sensors:

  • sensor.asuswrt_devices_connected
  • sensor.asuswrt_download (unit_of_measurement: Gigabyte - Daily accumulation)
  • sensor.asuswrt_download_speed (unit_of_measurement: Mbit/s)
  • sensor.asuswrt_upload (unit_of_measurement: Gigabyte - Daily accumulation)
  • sensor.asuswrt_upload_speed (unit_of_measurement: Mbit/s)

Padavan custom firmware (The rt-n56u project)

The rt-n56u project does not store dnsmasq.leases which is used to track devices at /var/lib/misc/ as asuswrt do. However this integration can still be used for the rt-n56u project by changing the dnsmasq location using the dnsmasq variable to dnsmasq: '/tmp' Also, to get the statistics for the WAN port, specify interface: 'eth3' as this is the interface used in the rt-n56u project