Aqara Home Assistant Integration Failing? Try These Fixes
If your Aqara devices are not appearing in Home Assistant or are showing as offline, you're not alone. This guide covers brand-specific solutions for Aqara's unique integration requirements, including HomeKit Secure Video, Matter bridge functionality, and model-specific reset procedures.
Quick Fixes to Try First
Before diving into complex diagnostics, try these 30-second checks:
- Power cycle your Aqara hub: Unplug the Camera Hub G3 for 30 seconds, then reconnect. This resolves many temporary connectivity issues.
- Check LED status on cameras: Aqara cameras blink blue when connected to Home Assistant. If the light is off or red, the device may be in pairing mode or disconnected.
- Verify Home Assistant app login: Ensure your Aqara Home app is logged in with the same account used for Home Assistant integration. Logout and re-login if needed.
- Confirm 2.4GHz network: Aqara cameras require 2.4GHz WiFi. Check your router settings to ensure the network is broadcasting on this band.
- Restart Home Assistant: Open the Supervisor dashboard and restart the Home Assistant container. This clears temporary glitches in the integration process.
Step 1: Check Your Aqara Camera's Wi-Fi Band Settings
Aqara cameras work exclusively on 2.4GHz networks. If your router uses a dual-band setup, ensure the camera is connected to the 2.4GHz network:
For Aqara Camera G100
- Open the Aqara Home app and go to Device Settings → Network → Wi-Fi Band.
- Select 2.4GHz if not already chosen. If this option is unavailable, your router may be broadcasting a single SSID for both bands. Contact your ISP for assistance.
For Aqara Camera E1
- Navigate to Device Settings → Network → Wi-Fi Band in the Aqara app.
- Ensure the camera is connected to a 2.4GHz network. If the camera shows Accessory Not Found in HomeKit, verify your Apple TV or HomePod is acting as a stable HomeKit hub.
Step 2: Update Aqara Camera Firmware via the App
Outdated firmware can cause Home Assistant integration failures. Follow these steps to update:
For All Aqara Cameras
- Open the Aqara Home app and go to Device Settings → Firmware Update.
- If an update is available, tap Update Now. Ensure the camera remains connected to power during the process.
- After updating, restart the camera by unplugging it for 10 seconds. Reconnect and wait for the LED to turn solid blue before re-adding it to Home Assistant.
For Aqara Camera Hub G3
- In the Aqara app, go to Hub Settings → Firmware → Update.
- If the hub requires a firmware update, follow the on-screen instructions. This is critical for HomeKit Secure Video and Matter bridge functionality.
Step 3: Configure RTSP/ONVIF Streams in Home Assistant
Aqara cameras use RTSP for Home Assistant integration. Ensure your configuration is correct:
For Aqara Camera G510 Battery
- In Home Assistant, open the Configuration → Devices & Services → Integrations menu.
- Add the RTSP Camera integration. Enter the camera's IP address and use port 554 as the default.
- For ONVIF, use the ONVIF Camera integration and input the camera's IP address. Confirm the port is set to 80.
For Aqara Camera E1
- Use the RTSP Camera integration with the default port 554.
- If using MQTT, ensure your broker is configured with the default topic aqara/camera/e1/. Disable TLS encryption unless required by your network.
Step 4: Reset Aqara Devices for Re-Pairing
If integration fails after updates, perform a factory reset:
For Aqara Camera E1
- Locate the reset button on the camera's rear panel.
- Press the button 10 times rapidly or hold for 3 seconds until a confirmation sound plays and the LED blinks blue.
- Re-add the camera to the Aqara app: Add Device → Camera → Select Model → Follow Setup Instructions.
For Aqara Camera G510 Battery
- Use a paperclip to press and hold the reset button for 10 seconds until the LED blinks blue.
- Re-pair via the Aqara app as described above.
Step 5: Use Aqara's Network Diagnostics Tool
Aqara's Network Diagnostics feature can identify connectivity issues:
- Open the Aqara Home app and go to Device Health → Network Diagnostics.
- Tap Run Test. The app will check signal strength, interference, and IP address conflicts.
- If the test shows low signal strength (RSSI below -70dBm), move the camera closer to your router or use a WiFi extender.
- For Aqara Camera Hub G3 users, ensure the hub's IP address is within the same subnet as your router (e.g. 192.168.1.x).
Advanced Diagnostics: Check Home Assistant Logs
If basic fixes fail, review Home Assistant logs for clues:
- In the Supervisor dashboard, go to Logs → Home Assistant Container.
- Search for error messages related to Aqara devices (e.g. "No RTSP stream found").
- If logs show a MQTT connection error, check your broker settings in Configuration → Devices & Services → MQTT.
- For HomeKit integration issues, ensure the Aqara Hub G3 is connected to the same HomeKit network as your Home Assistant instance.
When to Contact Aqara Support
If all steps fail, contact Aqara support via their official website: https://www.aqara.com/eu/support. Provide the following details:
- Model numbers of affected devices
- Home Assistant version and integration method (HACS/core)
- Screenshots of the Device Health section in the Aqara app
- Home Assistant logs related to Aqara devices
Understanding Common Causes
Persistent Aqara Home Assistant issues often stem from:
- Incorrect RTSP/ONVIF stream configuration (e.g. wrong IP address or port)
- Outdated firmware on cameras or the Aqara Hub G3
- HomeKit network conflicts (e.g. the hub is not properly connected to the same network as Home Assistant)
- Router settings blocking necessary ports (e.g. port 554 for RTSP or port 1883 for MQTT)
UK-specific challenges include Virgin Media Hub 5x double NAT and EE/Three/Vodafone CGNAT, which can prevent remote access to cameras. If you're using a commercial ISP, consult your provider for port forwarding assistance.
Prevention and Long-Term Care
To avoid future Aqara Home Assistant issues:
- Regularly update firmware via the Aqara app
- Use 2.4GHz networks exclusively for Aqara devices
- Monitor signal strength using the Device Health section
- Back up Home Assistant configurations regularly
Full disclosure: we built scOS to address exactly this—the frustration of cameras that depend on Wi-Fi to function. scOS uses permanently powered cameras connected via ethernet, eliminating the need for frequent resets and firmware updates.
Replacement Decisions
Aqara cameras typically last 3-5 years for battery models and 5-8 years for wired models. Signs of replacement include:
- Persistent connectivity failures despite firmware updates
- Battery degradation (e.g. G510 Battery holds less than 20% charge after 300 cycles)
- Sensor issues (e.g. G100 shows distorted video)
- Aqara Hub G3 firmware end-of-life (EOL) Under the Consumer Rights Act 2015, UK consumers have up to 6 years to claim faulty goods (5 years in Scotland). If your device is under warranty, contact Aqara support immediately.