• Homebridge: Version >=1.9.0. Install from homebridge.io.
• Homebridge UI: Highly recommended. Mandatory if you have 2FA enabled on your Eufy account.
• Node.js: Version 20, 22, or 24. See Node.js Compatibility for streaming-compatible versions.
• Dedicated Admin Account: You must create a separate Eufy account for the plugin (see below).

Using the same account for both the Eufy App and the plugin can cause unexpected issues (concurrent session conflicts). Create a dedicated admin account before installing.

Note: In the eufySecurity app (v4.0+), there are two methods to share access: Share Home and Share Device. For certain devices, you can also share directly from the product settings page.

1. Create a New Account

   • Log out from your current Eufy App.
   • Register a new account using a different email address.
   • How to sign up for a eufySecurity account

2. Invite the New Account

   • Log in with your main account.
   • Choose one of these methods:
     • Share Home: Side Menu > Share Management > Share Home > Invite > Enter the new email address
     • Share Device: Side Menu > Share Management > Share Device > Invite > Choose Admin > Select devices > Enter the new email address

3. Assign Admin Rights

   • You must grant the new account admin rights, not guest rights. Guest rights will cause errors.

4. Accept the Invitation

   • The plugin automatically accepts invitation requests. The new account is ready to use.

• Shared Account Limit: Eufy allows up to 5 shared accounts. Only the primary account can share access.
• Invitation Issues: If the invited account only receives an email but no in-app notification, contact Eufy support. Ensure 2FA is turned off for the shared account during setup.
• Region Matching: Both accounts must be in the same login environment. Check: App > Side Menu > Settings > Region.
• No spaces in email: Ensure there are no leading/trailing spaces when entering the email address.

1. Navigate to the 'Plugins' page.
2. Search for homebridge-eufy-security or @homebridge-plugins/homebridge-eufy-security.
3. Click 'Install'.

sudo npm i @homebridge-plugins/homebridge-eufy-security -g

After installation, a configuration popup will automatically appear. If it does not, go to the 'Plugins' page and click 'Settings' on the plugin tile.

Enter your eufy credentials for the dedicated admin account you created above. It is important to choose the same country that you have set up in your eufy account.

If you have enabled 2FA, the config UI will guide you through the process. After successfully logging in, you should see an overview of the eufy devices connected to your account.

Here you can change settings for the overall behaviour of the plugin, download log files, or clear stored data. See Reset/Clear for more information.

Click on any device icon to edit its settings. The available settings depend on the device type.

Tips to get started:

• New cameras default to motion sensor only mode. You must enable camera mode in the device settings. (Doorbells are always cameras by default.)
• Audio is not enabled by default.
• Consider unbridging devices where available — this improves stability. See Bridged and Unbridged Mode.
• Low-end hardware (Raspberry Pi) may struggle with simultaneous streaming, snapshots, and HKSV recording.
• Some devices appear multiple times in the overview because they act as both camera and station.

For streaming settings, see Streaming. For HKSV, see HomeKit Secure Video.

Although the plugin handles a lot of functionality, some settings can only be configured in the official Eufy app:

• Stream quality: The input stream quality affects what the plugin receives for encoding. See Streaming.
• Push notifications: Required for real-time device updates (motion events, sensor status). See Common Issues.
• Motion detection sensitivity and zones

This plugin depends on the eufy-security-client library. We convert device capabilities to HomeKit as closely as possible, but some features may not yet be available through the underlying library.

Supported devices list: eufy-security-client Supported Devices

{
  "platform": "EufySecurity",
  "username": "[email protected]",
  "password": "your-password"
}

{
    "platform": "EufySecurity",
    "username": "[email protected]",
    "password": "your-password",
    "pollingIntervalMinutes": 30,
    "hkHome": 1,
    "hkAway": 0,
    "hkNight": 3,
    "hkOff": 63,
    "enableDetailedLogging": false,
    "ignoreStations": [],
    "ignoreDevices": [],
    "country": "US",
    "CameraMaxLivestreamDuration": 30
}

Restart Homebridge after completing the configuration. Your supported Eufy Security devices should now appear in HomeKit.