51 lines
2.1 KiB
Markdown
51 lines
2.1 KiB
Markdown
---
|
|
title: Ruckus Unleashed
|
|
description: Instructions on how to integrate your Ruckus Unleashed device into Home Assistant.
|
|
ha_category:
|
|
- Presence Detection
|
|
ha_release: 0.117
|
|
ha_iot_class: Local Polling
|
|
ha_config_flow: true
|
|
ha_codeowners:
|
|
- '@gabe565'
|
|
ha_domain: ruckus_unleashed
|
|
ha_platforms:
|
|
- device_tracker
|
|
---
|
|
|
|
This platform allows you to connect to a [Ruckus Unleashed](https://support.ruckuswireless.com/product_families/19-ruckus-unleashed) access point.
|
|
|
|
There is currently support for the following device types within Home Assistant:
|
|
|
|
- **Presence Detection** - The platform will look at devices connected to the access point and will create a `device_tracker` for each discovered device.
|
|
|
|
## Configuration
|
|
|
|
To add a Ruckus Unleashed device to your installation, go to **Configuration** -> **Devices & Services**, click the `+` button, then select **Ruckus** from the list of integrations.
|
|
|
|
It is required to configure the IP address of your **master access point**. See the section Access Points on the management web interface. And perhaps consider to set a preferred master (Admin & Services>System>System Info>Preferred master).
|
|
|
|
You will have to create a user on the device which is a **Monitoring Admin**. Login to the Ruckus Unleashed admin UI and follow these steps:
|
|
|
|
- [Create a new role](https://docs.ruckuswireless.com/unleashed/200.1.9.12/t-ConfigUserRoles.html).
|
|
- Check **Allow Unleashed Administration**.
|
|
- Select the **Monitoring Admin (Monitoring and viewing operation status only)** radio button.
|
|
- [Create a new user](https://docs.ruckuswireless.com/unleashed/200.1.9.12/t-AddingNewUsersInternal.html) with the new role.
|
|
|
|
## Troubleshooting
|
|
|
|
For this platform to work, the Ruckus Unleashed device will need to be accessible over SSH. If you are having trouble with Home Assistant not connecting, make sure the user you created above can log in to SSH and can run privileged commands.
|
|
|
|
Terminal:
|
|
|
|
```bash
|
|
ssh <ruckus_ip>
|
|
|
|
Please login: <username>
|
|
Password: <password>
|
|
Welcome to Ruckus Unleashed Network Command Line Interface
|
|
ruckus> enable
|
|
ruckus# exit
|
|
Exit ruckus CLI.
|
|
```
|