About
Local-push Home Assistant integration for local control of Aqara hubs, their sub-devices, and cameras over the LAN
Description from absent42/Aqara-LANLink
Shows in Vulpo
Light card, Quick Toggle card, Camera card, Button card, Apple Watch, Control Center.Installs over time
#1,620 of 1,637 Marketplace integrations, down 3 places in 30 days. Installs sharing analytics.
Supports
- Works locallyTalks to your devices on your own network. No vendor cloud in between.
- From the MarketplaceInstalled through the Marketplace, formerly HACS.
- Actively maintainedIts author released or pushed a change in the last six months.
Provides
- Lights
- Cameras
- Switches
- Sensors
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Add Aqara device
- Device IP address
- Device DID
Aqara cloud credentials
- Aqara account email
- Aqara account password
- Aqara region
- Aqara user ID (optional, advanced)
- Aqara token (optional, advanced)
Also asked when signing in again and changing the connection.
After setup
- Camera IP address
- RTSP username
- RTSP password
- Two-way-audio channel (1 high, 2 medium, 3 low)
Texts from the code of absent42/Aqara-LANLink.
Entities
- ButtonsPan up, Pan down, Pan left, Pan right, Stop movement, Zoom in, Zoom out
- CamerasHigh quality, Medium quality, Low quality
- NumbersDetection clear delay, Zoom
- SelectsPreset
Actions
- Play audio fileStream an AAC-ADTS audio file through an Aqara doorbell's voice channel.
- Doorbell
- File path
- Scan device for new traitsRuns a one-shot cloud scan against one Aqara device to recover traits the shipped catalogue is missing. Intended for the small number of models not yet catalogued, or when firmware adds new traits to a previously catalogued model; not needed for routine use.
- Device
- Export overlay for PRRenders accepted overlay traits as a Python TraitSpec snippet ready to paste into a model package's overrides.py OVERRIDES dict, then posts the result as a Persistent Notification. Intended for submitting catalogue PRs after running scan_device.
- Model
- PTZ controlControl a PTZ camera with a single action. The command selects what to do; value, continuous, and duration refine it. One service so dashboards (including the WebRTC card) can drive every PTZ action through one action key.
- Command
- Value
- Continuous
- Duration
Troubleshooting
- DiagnosticsDownloads a diagnostics file to attach to a bug report.
- Repair noticesNotices it can show in Settings, Repairs:Aqara hub stopped sending updates, New device capabilities observed
From the README
A local-push Home Assistant integration for Aqara hubs, their sub-devices, and cameras giving local control over the network LAN, using the reverse-engineered Aqara LANLink and P2P protocols.
Device state is pushed from the hub to Home Assistant over a persistent encrypted TCP LAN connection; no polling or cloud roundtrip.
- ~379 Aqara device models supported out of the box, from a shipped device catalogue.
- Local push, no polling - device state is pushed from the hub over a persistent encrypted LANLink tunnel; state changes reach Home Assistant with no cloud round-trip.
- Multiple Aqara hubs in a cluster, and mutliple hubs bound to different regions.
- Multiple entity types - switches, sensors, binary sensors, lights, numbers, selects, buttons, and events are derived from each device's catalogue with names, values and labels.
- Local device settings - sub-device configuration settings (child lock, indicator light, button mode, power-off memory, max power, find/restart etc) are exposed as switch, select, number, text, and…
- Cameras and doorbells - RTSP streaming via go2rtc, doorbell ring events, motion/occupancy/gesture etc detection events and sensors, and two-way audio (talk-back) through the go2rtc backchannel.
- Local camera PTZ - pan/tilt/zoom and saved-position presets for supported cameras, as buttons, a preset selector, and services.
Information
- Installs
- 50 sharing analytics
- GitHub stars
- 31
- Connection
- Works locally
- Upkeep
- Updated in the last 6 months
- Version
- v0.5.3,
- Category
- Hubs and protocols, Smart home hubs
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
aqara_lanlink- Issues
- Report an issue
You might also like
Try it with your own Home Assistant.

- Free to download
- iPhone, iPad, Mac and Apple Watch
- 40+ native card types
- Connects to your own Home Assistant











