Having Trouble with Your Eufy and Home Assistant Integration?
Integrating your Eufy security devices into Home Assistant opens up a world of powerful automation possibilities. You can trigger lights when a Eufy camera detects motion, announce "person detected at the front door" on your smart speakers, or create complex automations based on your doorbell being pressed.
However, because the integration relies on community-developed solutions rather than official Eufy support, it can sometimes be tricky to set up and maintain. If your Eufy devices aren't appearing, camera streams are broken, or sensors are unresponsive, this guide will help you troubleshoot the most common issues.
Common Stumbling Blocks with Eufy and Home Assistant
The integration works by reverse-engineering the Eufy cloud and local protocols. This makes it powerful but also susceptible to breaking when Eufy makes changes. Here are the usual suspects when things go wrong:
- Authentication Errors: Incorrect Eufy account credentials or problems with captcha verification during setup.
- Network Complexity: Home Assistant and Eufy devices being on different VLANs or subnets can prevent discovery and local communication.
- Outdated Integration: The community is constantly updating the integration to keep up with Eufy's changes. An old version will likely fail.
- Eufy App Settings: Features like RTSP (Real-Time Streaming Protocol) for camera streams must often be enabled in the Eufy Security app first.
- Firewall Rules: Network firewalls can block the ports and protocols the integration needs to communicate with your Eufy HomeBase and devices.
Troubleshooting Your Eufy Home Assistant Integration
Let's work through the solutions methodically.
1. Use a Dedicated Secondary Eufy Account
This is a highly recommended best practice. Do not use your main Eufy administrator account for the Home Assistant integration.
- In the Eufy Security app, invite a new user with a separate email address. Grant this user "Admin" privileges.
- Use the login credentials for this new, secondary account when you configure the Eufy Security integration in Home Assistant.
- This prevents issues with lockouts and authentication conflicts caused by your phone app and Home Assistant trying to connect simultaneously.
2. Update the Integration via HACS
The most common cause of a broken Eufy integration is an update on Eufy's side. The first place to check for a fix is the Home Assistant Community Store (HACS).
- In Home Assistant, go to HACS > Integrations.
- Find the "Eufy Security" integration in your list of installed repositories.
- If an update is available, you will see a notification. Update the integration and restart Home Assistant.
3. Check Your Network Configuration
Simplicity is key for troubleshooting.
- Same Subnet: Ensure your Eufy HomeBase, cameras, and the device running Home Assistant are all on the same local network and subnet (e.g., all have IP addresses like 192.168.1.x).
- Firewall: Temporarily disable any firewalls between these devices to see if that resolves the issue. If it does, you'll need to create specific "allow" rules for the traffic.
- Use a Wired Connection: If possible, connect your Home Assistant server to your network via an Ethernet cable rather than Wi-Fi for maximum stability.
4. Enable RTSP for Camera Streams
If your problem is specifically with viewing live camera feeds in Home Assistant, you need to enable RTSP for each camera.
- Open the Eufy Security app on your phone.
- Select the camera you want to stream.
- Go to Camera Settings > Storage > NAS (RTSP).
- Toggle the RTSP Stream switch to ON.
- The integration should then be able to automatically find and use this stream.
5. Restart Everything
When in doubt, a full restart can often resolve strange connectivity issues.
- Restart your Eufy HomeBase.
- Restart your Eufy cameras and doorbells.
- Restart your Home Assistant server (go to Settings > System and click Restart in the top right).
By carefully checking these common problem areas, you can usually resolve Eufy integration issues and unlock the full potential of your smart security system within Home Assistant.