Jul 7, 2021

How to integrate eufy security cameras with Home Assistant

Disclosure: This post contains affiliate links. If you click through and make a purchase, I’ll earn a commission, at no additional cost to you. Read my full disclosure here.

Latest update: Add-on and new features

Good news for those running Home Assistant or Supervised, the eufy integration can now be installed as an add-on. Since writing this article, there have been many improvements to the custom component. My camera can now detect crying, pets, people, sound, motion.

Cameras from eufy Security have deservedly come under scrutiny in the past months. I was caught between a rock and a hard place when debating whether to write this guide on how to integrate eufy Security cameras and doorbells with Home Assistant. On the one hand, I don't recommend anyone use or even consider eufy products any more, as their reaction to the massive security breach (or bug, as they called it) was, and still is, unsatisfactory. On the other hand, I do want to inform those that absolutely insist on using them about the possibility of integrating them with Home Assistant.

Added to that, I unfortunately still have an eufy Solo IndoorCam (the cameras seems to have undergone a rebranding from Indoor Cam Pan&Tilt) in use. Replacing it would currently be an unnecessarily added cost at this moment. I can imagine that I am not the only user of Home Assistant currently in this situation.

With that in mind, you are free to follow this guide, but I do not recommend you purchase any eufy Security products just to set up this integration. There are plenty of alternatives on the market, many of them featuring a setup just as easy as eufy's. One brand that gets frequently recommended in the Home Assistant community is Reolink. I, personally, have no experience using their security cameras, but many others have, and have continued using their products.

REOLINK Indoor Security Camera, 5MP Super HD Plug-in WiFi Camera with PTZ, Auto Tracking, Human/Pet AI, Ideal for Baby Monitor/ Pet Camera/Home Security, Dual Band WiFi, Local Storage, E1 Zoom

REOLINK Security Camera Outdoor, 5MP HD IP PoE Dome Surveillance Camera, Work with Smart Home, 100ft IR Night Vision, Motion Detection, Up to 128GB Micro SD Card (Not Included), RLC-520

REOLINK 4K Outdoor Security Camera System, Home Surveillance IP PoE Camera with 3X Optical Zoom & 25FPS Daytime Video, Human/Vehicle/Pet Detection, Work with Smart Home, Up to 256GB SD Card, RLC-822A

REOLINK Outdoor Security Camera Wireless Rechargeable Battery 1080P Home Surveillance Support Cloud Google Assistant Night Vision PIR Motion Detection SD Slot | Argus Pro with Solar Panel

Product
Reolink E1 Zoom

Reolink RLC-520

Reolink RLC-822A

Reolink Argus 3 Pro with Solar Panel

Resolution
2560 × 1920 (5 MP)

2560 × 1920 (5 MP)

3840 × 2160 (4K)

2K (4 MP)

Night vision
Infrared night vision (12 m)

Infrared night vision (30 m)

Infrared night vision (30 m)

Spotlight activated by motion detection

Pan & tilt
355° horizontally, 50° vertically

-

PTZ

-

Zoom
3 × optical

-

3 × optical

-

AI features
Smart motion detection

Smart motion detection

Human/vehicle detection

Person/vehicle detection

FOV
98° horizontally

80°

50° - 94°

360° Horizontal, 130° Vertical

Weather proof?
No

Yes, IP66

Yes, IP66

Yes, IP65

Connectivity
2.4GHz and 5GHz dual-band Wi-Fi

PoE (Single cable for data and power)

PoE (Single cable for data and power)

2.4/5GHz Dual Band Wi-Fi

Price
$63.99

Price not available

$99.99

Price not available

-

-

REOLINK Indoor Security Camera, 5MP Super HD Plug-in WiFi Camera with PTZ, Auto Tracking, Human/Pet AI, Ideal for Baby Monitor/ Pet Camera/Home Security, Dual Band WiFi, Local Storage, E1 Zoom

Product
Reolink E1 Zoom

Resolution
2560 × 1920 (5 MP)

Night vision
Infrared night vision (12 m)

Pan & tilt
355° horizontally, 50° vertically

Zoom
3 × optical

AI features
Smart motion detection

FOV
98° horizontally

Weather proof?
No

Connectivity
2.4GHz and 5GHz dual-band Wi-Fi

Price
$63.99

REOLINK Security Camera Outdoor, 5MP HD IP PoE Dome Surveillance Camera, Work with Smart Home, 100ft IR Night Vision, Motion Detection, Up to 128GB Micro SD Card (Not Included), RLC-520

Product
Reolink RLC-520

Resolution
2560 × 1920 (5 MP)

Night vision
Infrared night vision (30 m)

Pan & tilt
-

Zoom
-

AI features
Smart motion detection

FOV
80°

Weather proof?
Yes, IP66

Connectivity
PoE (Single cable for data and power)

Price
Price not available

-

REOLINK 4K Outdoor Security Camera System, Home Surveillance IP PoE Camera with 3X Optical Zoom & 25FPS Daytime Video, Human/Vehicle/Pet Detection, Work with Smart Home, Up to 256GB SD Card, RLC-822A

Product
Reolink RLC-822A

Resolution
3840 × 2160 (4K)

Night vision
Infrared night vision (30 m)

Pan & tilt
PTZ

Zoom
3 × optical

AI features
Human/vehicle detection

FOV
50° - 94°

Weather proof?
Yes, IP66

Connectivity
PoE (Single cable for data and power)

Price
$99.99

REOLINK Outdoor Security Camera Wireless Rechargeable Battery 1080P Home Surveillance Support Cloud Google Assistant Night Vision PIR Motion Detection SD Slot | Argus Pro with Solar Panel

Product
Reolink Argus 3 Pro with Solar Panel

Resolution
2K (4 MP)

Night vision
Spotlight activated by motion detection

Pan & tilt
-

Zoom
-

AI features
Person/vehicle detection

FOV
360° Horizontal, 130° Vertical

Weather proof?
Yes, IP65

Connectivity
2.4/5GHz Dual Band Wi-Fi

Price
Price not available

-

Table of Contents

Preparation: Installing eufy-security-ws

For those wondering, there unfortunately doesn't appear to be an easy way of adding the eufy-security-ws application, which I will be using in this guide, to a supervised Home Assistant setup or one using the Home Assistant Operating System. Currently, there is no add-on available and the only way of installing it is by setting up a Docker container or by using a npm (Node Package Manager) package. I went the former route and set up the Docker container on my Unraid server.

The eufy Security logo

Developer Aaron Bach is working on an improved eufy integration with Home Assistant, with one of the goals being to publish it as an add-on. However, there is currently no release date and as the developer is using their free time to make it happen, it would be unfair to make demands. This upcoming integration will once again be a custom component, without any financial incentives.

eufy security Solo IndoorCam P24, 2K, Pan & Tilt, Indoor Security Camera, Wi-Fi Plug-in Camera, Human & Pet AI, Voice Assistant Compatibility, Night Vision, Motion Tracking, HomeBase not Compatible

eufy security Solo IndoorCam C24, 2K Security Indoor Camera, Plug-in Camera with Wi-Fi, IP Camera, Human & Pet AI, Voice Assistant Compatibility, Night Vision, Two-Way Audio, HomeBase not Compatible

eufy security eufyCam 2 Wireless Home Security Camera System, 365-Day Battery Life, HomeKit Compatibility, HD 1080p, IP67 Weatherproof, Night Vision, 2-Cam Kit, No Monthly Fee

eufy security Floodlight Cam 2 Pro, 360-Degree Pan and Tilt Coverage, 2K Full HD, Smart Lighting, Weatherproof, On-Device AI Subject Lock and Tracking, No Monthly Fee, Hardwired

Product
eufy Security Solo IndoorCam P24

eufy Security Indoor Cam 2K

eufy Security eufyCam 2 (2-Cam Kit)

eufy Security Floodlight Cam 2 Pro

Resolution
2K

2K

1080p

2K

Night vision
Infrared Night Vision (10 m)

Infrared Night Vision (10 m)

Advanced night vision with Sony Starvis sensor

3000 lm motion-activated floodlights

Pan & tilt
360° Horizontal, 96° Vertical

-

-

360°

AI features
Human/pet/crying detection

Human/pet/crying detection

Human/face detection

Human subject lock and tracking

FOV
125°

125°

140°

360° Horizontal, 130° Vertical

Weather proof?
No

No

Yes, IP67

IP65

Price
$54.99

$42.99

$279.99

$299.99

-

eufy security Solo IndoorCam P24, 2K, Pan & Tilt, Indoor Security Camera, Wi-Fi Plug-in Camera, Human & Pet AI, Voice Assistant Compatibility, Night Vision, Motion Tracking, HomeBase not Compatible

Product
eufy Security Solo IndoorCam P24

Resolution
2K

Night vision
Infrared Night Vision (10 m)

Pan & tilt
360° Horizontal, 96° Vertical

AI features
Human/pet/crying detection

FOV
125°

Weather proof?
No

Price
$54.99

eufy security Solo IndoorCam C24, 2K Security Indoor Camera, Plug-in Camera with Wi-Fi, IP Camera, Human & Pet AI, Voice Assistant Compatibility, Night Vision, Two-Way Audio, HomeBase not Compatible

Product
eufy Security Indoor Cam 2K

Resolution
2K

Night vision
Infrared Night Vision (10 m)

Pan & tilt
-

AI features
Human/pet/crying detection

FOV
125°

Weather proof?
No

Price
$42.99

eufy security eufyCam 2 Wireless Home Security Camera System, 365-Day Battery Life, HomeKit Compatibility, HD 1080p, IP67 Weatherproof, Night Vision, 2-Cam Kit, No Monthly Fee

Product
eufy Security eufyCam 2 (2-Cam Kit)

Resolution
1080p

Night vision
Advanced night vision with Sony Starvis sensor

Pan & tilt
-

AI features
Human/face detection

FOV
140°

Weather proof?
Yes, IP67

Price
$279.99

-

eufy security Floodlight Cam 2 Pro, 360-Degree Pan and Tilt Coverage, 2K Full HD, Smart Lighting, Weatherproof, On-Device AI Subject Lock and Tracking, No Monthly Fee, Hardwired

Product
eufy Security Floodlight Cam 2 Pro

Resolution
2K

Night vision
3000 lm motion-activated floodlights

Pan & tilt
360°

AI features
Human subject lock and tracking

FOV
360° Horizontal, 130° Vertical

Weather proof?
IP65

Price
$299.99

The installation is rather straightforward, and if you opt for the Docker container, you will only need to configure a port, persistent directory, and enter your username and password. Once started, the log message push notification connection successfully established will indicate that your account has successfully been connected.

Advantages of using eufy-security-ws

The eufy-security-ws application is a wrapper for the eufy-security-client library, with both being developed by bropat. The eufy-security-client library allows for communication with the unofficial eufy Security API. Using the unofficial API has several advantages compared to other solutions such as the Eufy Home Assistant MQTT Bridge:

  • The eufy-security-ws library connects to Eufy cloud and supports 2FA. Despite that, it can use P2P communication to connect to devices. It can also get information and parameters from devices over HTTPS and/or P2P.
  • It supports receiving push notification.
  • Depending on the device, it allows you to toggle auto night vision, the LED, the anti-theft detection, motion, pet, and sound detection, and the RTSP stream.
  • The eufy-security-ws library also provides the option to change the video watermark settings, start or cancel video downloads, send quick responses to doorbells, and lock or unlock smart lock devices.

All of these features sound great. However, the integration with Home Assistant relies on the eufy_security component developed by fuatakgun (more on that in a second) and not all features have been implemented so far. For example, despite being capable of detecting crying, my eufy Solo IndoorCam does not display a binary sensor for that function in Home Assistant.

Known working eufy devices

A list of eufy devices that have been confirmed to be working can be found in the GitHub repository. These include the eufy HomeBase, HomeBase E, and HomeBase 2, wired and battery-powered doorbells, the eufy IndoorCam, and eufyCam. The Smart Lock Front Door and a number of sensors can also be integrated.

Adding eufy_security to Home Assistant

Once eufy-security-ws is up and running, the eufy_security can be added to Home Assistant. The easiest way of doing this is (you guessed it) by using HACS. Simply copy and paste the repositories URL https://github.com/fuatakgun/eufy_security in to HACS and install the component. Once installed, you will need to restart Home Assistant.

A new repository being added to HACS
The repository for the integration of eufy security cameras with Home Assistant being added to HACS
The installed custom integration for eufy security cameraswith Home Assistant

Configuring the eufy custom component

Once the custom component has been installed, navigate to the integrations' section of the configuration and add a new integration. Searching for “eufy” should bring up the newly added custom component.

There are only two bits of information you have to provide: The first is the IP address of the server on which eufy-security-ws is running, the second is the application's port. Keep in mind that you do not need to enter the IP address of any devices, and a single setup will add all the eufy devices linked to the account you configured in eufy-security-ws.

Controlling the eufy security cameras in Home Assistant

With your eufy security cameras added to Home Assistant, you might want to display them in your Lovelace dashboard, perhaps using the WebRTC custom component. As I did, you might be wondering why no image is being shown, after having embedded the cameras. This isn't an error but a feature: Due to some devices being battery-powered, the stream is deactivated by default. One solution is to add some controls to the dashboard. The developer of the plugin has posted the configuration for a couple of buttons to control the camera in the Home Assistant community. I, personally, have set my camera to always stream, as it powered using a USB cable.

5 thoughts on “How to integrate eufy security cameras with Home Assistant”

  1. Hmm I’m using Eufy cameras in HA through rstp and webRCT and that works great – Im leaving motion detection / recording/ and other in native app and I use HA for streaming RSTP only. I have tried other rstp integrations but most of them is extremally havy for resources. But it’s true I would hesitate to buy Eufy product againd due to privacy concerns. I would like expanded rstp webRCT funtionality for HA no matter camera but so far its still not that bad.

    Reply
  2. Please update this post, integration is now working with add ons and improved so much. You can find up to date information directly on repository.

    Reply

Leave a comment

Share to...