Back to all devices

Aqara WS-K08E in Home Assistant

Wall switches · Zigbee · Light switch H2 EU (double rocker)

Zigbee2MQTT Quirk proposed, not merged yet 1 open report

Zigbee device – see the note above on what ZHA needs for it.

Brand: Aqara
Model: WS-K08E
Device type: Wall switches
Radio: Zigbee
Power: Mains powered
Reports itself as: lumi.switch.agl010
Also sold as: Aqara WS-K08D
Zigbee2MQTT: Device page on zigbee2mqtt.io

How the device gets into Home Assistant

official ZHA – with a Zigbee coordinator and the ZHA integration; for all its functions it needs a custom quirk, see above. Integration
official Aqara hub – paired with an Aqara hub that works as a Matter bridge (such as the M3 or M2), which shares supported devices with Home Assistant. Integration
add-on Zigbee2MQTT – Zigbee2MQTT runs as an add-on and passes the device on to Home Assistant over MQTT. Integration · Source

Known problems and fixes

Requests for ZHA support

support requested The Aqara light switch is not working with ZHA, so it cannot control lights. Adding support would let Home Assistant manage lighting via the switch. since March 12, 2025 · zha-device-handlers #3957

ZHA quirks for this device

Quirk proposed, not merged yet Recommended quirk

Proposed to ZHA and waiting for review – the maintainers check it before it becomes part of Home Assistant.

Adds: LED indicator Flip LED indicator Power on mode Operation mode left Operation mode right Lock relay left Lock relay right Multi click left Multi click right Operation mode +8

Source: zha-device-handlers · pull request #5431 · by @boswelja · October 10, 2026 · 1 approval
Signature: Aqara / lumi.switch.agl010

5 more quirks for this device

Quirk proposed, not merged yet Aqara / lumi.switch.agl010 zha-device-handlers · pull request #4141 · by @lonevvolf · June 22, 2025
Custom quirk shared in an issue Aqara / lumi.switch.agl010 zha-device-handlers · issue #3957 · by @lonevvolf · June 19, 2025
Custom quirk shared in an issue Aqara / lumi.switch.agl010 zha-device-handlers · issue #3957 · by @lonevvolf · June 17, 2025
Custom quirk shared in an issue Aqara / lumi.switch.agl010 zha-device-handlers · issue #3957 · by @lonevvolf · June 14, 2025
Custom quirk shared in an issue Aqara / lumi.switch.agl010 zha-device-handlers · issue #3957 · by @lonevvolf · June 8, 2025 · 2 approvals

The quirk is not part of ZHA yet. You can use it as a custom quirk until it is:

Tell ZHA where custom quirks are kept – in configuration.yaml:
```
zha:
  custom_quirks_path: /config/custom_zha_quirks/
```
Create that folder and save the quirk as a .py file in it.
Restart Home Assistant. If the device was paired before, reconfigure it or remove and pair it again so the quirk is applied.
Check it worked: the device page shows the quirk under Zigbee info.

A custom quirk has not been reviewed by the ZHA maintainers. Delete the file once the quirk is part of a Home Assistant release – otherwise the old copy takes precedence.

All quirks in the ZHA quirk database →

Alternatives

The same job from other makers – devices of the same type and radio that work with Home Assistant too.

SONOFF ZBMINIR2 Wall switches · Zigbee · Zigbee smart switch Zigbee2MQTT ZHA quirk 3 open reports Review · from 17.03 €
Tuya TS0001_switch_module Wall switches · Zigbee · 1 gang switch module Zigbee2MQTT Custom quirk needed 3 open reports Review
AduroSmart 81849 Wall switches · Zigbee · ERIA Built-in Dimmer Zigbee2MQTT Review
BTicino 3584C Wall switches · Zigbee · Connected lighting micromodule Zigbee2MQTT Review