Eufy Security Viewer

View Eufy camera snapshots, watch live video with optional sound, and browse existing HomeBase recordings in Home Assistant. This is an independent project, not affiliated with Eufy or Anker.

Install · Upgrade · Compatibility and help

Before you start

You need Home Assistant 2026.9.0 or newer, HACS, and a Eufy account that can see your cameras in the Eufy app.

Install both parts:

• Eufy Security Viewer Bridge connects to your cameras. Run it as a Home Assistant OS app or in Docker on your local network.
• Eufy Security Viewer adds the integration and dashboard cards through HACS. HACS does not install or update the bridge.

Bridge builds are available for 64-bit Intel/AMD and ARM machines. Raspberry Pi hardware validation is still pending. A Eufy cloud recording subscription is not needed for the tested HomeBase recordings. Check compatibility.

Installation

Already installed? Follow the upgrade guide instead.

1. Install the bridge on Home Assistant OS

1. Open Settings → Apps → Install app → ⋮ → Repositories and add:

   https://github.com/keesmod/ha-eufy-cam
   

2. Install Eufy Security Viewer Bridge.

3. In its configuration, set token to a unique random secret of at least 32 characters. Keep it for the next step. This is not your Eufy password.

4. Start the app and enable Start on boot.

Using Home Assistant Container or a separate bridge machine? Follow the Docker instructions, then continue below.

2. Install and connect the HACS integration

1. In HACS → ⋮ → Custom repositories, add the same repository URL as an Integration.
2. Download Eufy Security Viewer and restart Home Assistant.
3. Open Settings → Devices & services → Add integration → Eufy Security Viewer.
4. Enter http://127.0.0.1:8063 for the HAOS app on this HA machine, or the bridge address from your Docker setup. Enter the token you saved above.
5. Sign in with your Eufy email, password and two-letter country code, such as NL. Complete any verification step and check that your cameras appear.

Detailed installation and troubleshooting

3. Add the dashboard cards

Reload your browser, edit a dashboard and select Add card → Eufy Security Viewer. Pick a camera. Add Eufy Events to browse recordings across cameras. The cards are included with the integration.

Tap a camera to watch live video and enable sound if wanted. Close the viewer when finished. Idle images are the latest received snapshots and may be old. By default the live view opens as a popup and one camera per HomeBase is live at a time. For a surveillance-style view, set the card's live view to Inside the card in the editor, or in YAML:

type: custom:eufy-viewer-card
entity: camera.front_door
live_mode: inline

Each inline card still starts with a tap and stops when you close it or leave the page. Add live_autostart: true to an inline card to start it without a tap when the view opens, with pause, resume and stop controls on the card. Raise the bridge option live_max_streams_per_station to let more than one camera on the same HomeBase be live at once. See card options and live cameras per HomeBase.

Cards missing or resources managed in YAML?

The current card resource is /eufy_viewer/eufy-viewer-card.js?v=0.8.23. See manual card setup.

Upgrading

The 0.8.23 integration adds the card option live_mode: inline, which plays live video inside the card so several cameras can be live at once, and the optional live_autostart: true for inline cards, which starts them without a tap when the view opens with pause, resume and stop per card. The bridge stays at 0.8.21, which lets several cameras on one HomeBase stream live at the same time through the optional option live_max_streams_per_station (default 1, unchanged behaviour) and tells you when another camera on the HomeBase is live. Update the integration to 0.8.23 and the bridge to 0.8.21, then refresh the dashboard. The bridge includes client 0.13.0. See the release notes for changes and any version-specific instructions.

Upgrading from before 0.8.0? Follow the migration and recovery instructions before updating the bridge. These cover the removal of the old backend and the required integration-first preparation.

For installations already on 0.8.0 or newer:

1. Close live viewers and recordings. Back up Home Assistant and the bridge's private data.
2. Update Eufy Security Viewer in HACS and restart Home Assistant.
3. If your bridge is older than 0.8.21, update Eufy Security Viewer Bridge through the HA app store, or follow the Docker update steps.
4. Reload your dashboard and check snapshots, live video, recordings and events. If you manage card resources in YAML, use the current resource URL above.

Keep your existing integration, token, bridge data and backup. Do not run two bridges for the same installation at once.

Compatibility and help

You can upgrade without us having tested your exact camera. Available functions still depend on the model and connection. See known results and limitations.

• Live video falls back without sound? Download the integration diagnostics after one attempt. See live playback diagnostics.
• Recording or player error? Use Download diagnostics at the error or in the integration menu. See the playback report.
• Missing devices or failed setup? Collect a complete diagnostic report.
• Something does not work? Check troubleshooting. For live video or sound, see playback and connection requirements.
• Share your experience: report working or failing features. Partial results help. Reporting is voluntary.
• An existing issue matches your problem? Add your results there. Otherwise, report a bug. Remove private information before sharing logs.

For more detail: events and notifications, playback and recovery, development, and release process.