Eufy Security Integration Setup

Eufy Security devices connect to Home Assistant through a community-built stack with three parts: the Eufy Security add-on (which maintains the connection to your Eufy account), go2rtc (which handles video streaming), and the Eufy Security integration installed through HACS.

Before You Start

Confirm the following before you begin:

1. Your Home Assistant installation supports add-ons (Home Assistant OS or Supervised).
2. You have your Eufy account credentials available.
3. HACS is installed. If it is not, follow the HACS download guide first.

Step 1: Install the Eufy Security Add-on

Install the Eufy Security add-on by following the setup guide in the eufy-security-ws add-on repository .

The add-on connects to your Eufy account and exposes a local WebSocket service (port 3000 by default) that the integration uses.

Step 2: Install go2rtc

go2rtc is required for P2P streaming and improves performance for RTSP streaming. P2P streams use go2rtc to generate a stream with a specific RTSP address, and RTSP streams use it for faster playback.

There are two ways to install it:

1. WebRTC custom integration (recommended): includes go2rtc plus a front-end card for faster streaming. Follow the WebRTC integration guide .
2. Standalone go2rtc: if you prefer a dedicated go2rtc setup that is not bundled with the WebRTC integration, install it from the go2rtc repository .

Step 3: Install the Eufy Security Integration Through HACS

1. Open HACS in Home Assistant.
2. Search for Eufy Security in the HACS integrations list.
3. Install the Eufy Security integration.
4. Restart your Home Assistant instance.

Step 4: Add the Integration

1. Go to Settings > Devices & Services.
2. Select Add Integration and search for Eufy Security.
3. Enter the Eufy Security add-on host (127.0.0.1 for a Supervised installation) and the configured port (3000 by default).
4. Select Submit.

Step 5: Complete Captcha or MFA Checks

You might receive captcha or multi-factor authentication (MFA) warnings after adding the integration:

1. Open the integration and select Reconfigure.
2. The captcha code is shown on the reconfigure page. The MFA code is emailed or texted to you.
3. Enter the requested values.
4. Restart your Home Assistant instance if prompted.

Step 6: Connect go2rtc to the Integration

If you installed the WebRTC custom integration with go2rtc, or the standalone go2rtc add-on, enter its IP address on the integration configuration page. Use 127.0.0.1 for a Supervised installation.

Step 7: Adjust Optional Settings

On the integration configuration page you can also set the Cloud Scan Interval, Video Analyze Duration, and Custom Name 1, Custom Name 2, and Custom Name 3.

The custom names are labels for the first, second, and third custom guards (modes) you created in the Eufy Security app, ordered by created date. Because the built-in alarm panel card has no services that correspond to custom Eufy guards, the integration repurposes these services to trigger them:

• arm_custom_bypass triggers your first custom guard.
• arm_night triggers your second custom guard.
• arm_vacation triggers your third custom guard.

For example, if you create a “bedtime” mode in the Eufy Security app, calling arm_custom_bypass from the alarm panel card enables that mode, and Custom Name 1 controls how it is displayed.

Step 8: Enable Diagnostic Entities

Some entities are disabled after installation to avoid generating large amounts of data. This is expected behavior. To enable an entity:

1. Open one of the devices under the Eufy Security integration.
2. Scroll down to the Diagnostic section and select an entity.
3. Open the entity settings and turn on the Enabled and Visible options.
4. Wait about 30 seconds for the entity to become available.