2026.10.4
Home ▸ Integrations

QNAP QSW

This integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] interacts with the local API of QNAP QSW managed switches.

Configuration

To add the QNAP QSW device to your Home Assistant instance, use this My button:

QNAP QSW can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Manual configuration steps

If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select QNAP QSW.

  • Follow the instructions on screen to complete the setup.

URL

Device URL (usually http://IP)

Username

Username (usually admin)

Password

Password

Binary sensors

The following binary sensors are created:

Binary sensor Description
anomaly Device anomaly.

The following binary sensors are created for each port (or LACP):

Binary sensor Description
link Link status.

Buttons

The following buttons are created:

Button Description
reboot Reboot device.

Sensors

The following sensors are created:

Sensors Description
fan_1_speed Fan 1 Speed.
fan_2_speed Fan 2 Speed.
ports Number of used ports.
rx Total RX bytes.
rx_errors Total number of RX errors.
rx_speed Total RX speed.
temperature Switch temperature.
tx Total TX bytes.
tx_speed Total TX speed.
uptime Uptime seconds.

The following sensors are created for each port (or LACP):

Sensors Description
link_speed Link speed.
rx RX bytes.
rx_errors Number of RX errors.
rx_speed RX speed.
tx TX bytes.
tx_speed TX speed.

Update

Update Description
firmware_update Firmware update status.

Known limitations

The QNAP QSW firmware allows only one authenticated session at a time. Because this integration maintains a persistent session to poll the switch, you cannot sign in to the switch’s web management console (QSS) while the integration is active. Attempting to do so results in a “Duplicate login detected” error.

To access the switch’s web console, temporarily disable the integration under Settings > Devices & services, then re-enable it when you are done.

Removing the integration

This integration follows standard integration removal. No extra steps are required.

To remove an integration instance from Home Assistant

  1. Go to Settings > Devices & services and select the integration card.
  2. Next to the entry you want to remove, select the three dots menu. Then, select Delete.
    • Depending on the integration, the entries are listed under one of the following headings:
      • Devices
      • Hubs
      • Services
      • Integration entries
  3. To confirm, select Delete.
    • Home Assistant also deletes the devices and entities of the entry.
  4. If Home Assistant asks you to restart, restart Home Assistant.
  5. If Home Assistant asks whether to also delete the application credentials, select Remove or Keep.