- An AsusWRT-powered router. Including devices with original (stock) firmware (versions starting with
18.104.22.168) as well as with AsusWRT-Merlin FW and its derivatives (e.g. Gnuton builds).
- A Home Assistant instance with version 2023.1.0 or higher.
There are two supported ways to install AsusRouter to your HA instance - Home Assistant Community Store (HACS) and manual installation from the stable branch of the integration GitHub.
Keep in mind, manual installation of development (
main) branch is not and will not be supported!
You can add this repository to your HACS going the following path:
HACS -> Integrations -> Explore & Download Repositories -> AsusRouter
Copy content of the stable branch
custom_components/asusrouter/ in your Home Assistant folder.
After AsusRouter is installed, you can add your device from Home Assistant UI.
You need to specify the device IP address (e.g.
192.168.1.1) or hostname (e.g.
my.router.com) as the first step of integration setup. AsusRouter will automatically check whether you device can be reached.
|Hostname cannot be resolved||ERROR||The hostname cannot be resolved. Use the device IP address|
To connect to the device you need to provide the following minimum data:
- Username (for logging into the Web UI)
- Port (the default value
0will select either
80for non-SSL or
8443for SSL connection)
- SSL connection (
|Connection refused||ERROR||The device is refusing connection. Check the logs|
|Wrong credentials||ERROR||Check |
|Login is blocked||ERROR||Too many attempts with wrong credentials were made. The timeout value is provided in HA log|
|Error / Unknown||ERROR||Refer to the HA log for details|
When the setup is successful, you will be provided with advanced options.