--- title: "EcoFlow Energy" description: "EcoFlow Energy is a Marketplace integration for Home Assistant. It has 659 installs sharing analytics, needs the vendor's cloud and was last updated October 26, 2026." canonical: "https://vulpo.app/integrations/marketplace/shuette42-ecoflow-energy-ha" url: "https://vulpo.app/integrations/marketplace/shuette42-ecoflow-energy-ha.md" last-updated: "2026-10-25" version: "1.4" --- # EcoFlow Energy > EcoFlow Energy is a Marketplace integration for Home Assistant. It has 659 installs sharing analytics, needs the vendor's cloud and was last updated October 26, 2026. EcoFlow Energy connects EcoFlow power devices such as PowerOcean, Delta and Stream models to Home Assistant. It offers two cloud modes: one reads through the vendor's developer API with an access key and secret key, the other signs in with the EcoFlow account for faster updates. A three-phase PowerOcean can also be read locally over Modbus/TCP, without an account or cloud. It adds sensors, binary sensors, switches, numbers, selects and buttons, covering settings like backup reserve, work mode, charge limits and output toggles. Sensors are prepared for the Energy Dashboard, and an option records extra diagnostic data for 24 hours to help with bug reports. Setup is done in the UI, and the entity names and setup screens are available in six languages. Automatic summary of the README and code of shuette42/ecoflow-energy-ha. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=shuette42&repository=ecoflow-energy-ha&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=shuette42&repository=ecoflow-energy-ha&category=integration) ## Supports - **Uses the vendor's cloud**: Needs an internet connection and an account with the vendor. - **From the Marketplace**: Installed through the Marketplace, formerly HACS. - **Actively maintained**: Its author released or pushed a change in the last six months. ## Setting it up Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services. ### Connection Mode - **Connection Mode** ### EcoFlow Developer Credentials - **Access Key** - **Secret Key** Also asked when signing in again. ### EcoFlow App Login - **Email** - **Password** Also asked when signing in again and signing in again. ### Local Modbus/TCP Connection - **Host**: DNS name (or address) of the PowerOcean on your network. - **Port**: Modbus/TCP port of the device. 502 unless your device uses another one. - **Unit ID**: Modbus unit ID of the device. 1 unless it was changed. ### Select Devices - **Devices** ### After setup - **Connection Mode** - **Devices**: Selecting a device is what makes this integration read it. A device marked "not supported yet" has no parser here, so it produces two diagnostic sensors and nothing else. Leaving it selected is still worth doing, because a diagnostics download from it attached to a GitHub issue is what support for a new model is built from. Your diagnostics download already carries the raw data such a device reports, so nothing needs switching on first. - **Record extra diagnostic data for 24 hours**: Keeps more of the raw messages your devices send, records any device this integration does not support yet, and records the settings the EcoFlow app writes to your devices while it runs. That last one is how a control gets built for a model nobody here owns: changing the setting in the app once, with this on, shows what the device accepts. Only worth switching on if it was asked for in a GitHub issue, since the data is only useful attached to a diagnostics download. Nothing is ever sent to your devices, and the recording stops by itself after 24 hours. - **Track completed PowerPulse charging energy by vehicle**: Reads completed charging sessions from your EcoFlow account about every 5 minutes and keeps a local record of them in Home Assistant. The record is removed when you delete the integration. - **Access Key** - **Secret Key** - **Email** - **Password** - **Connection Mode** - **Devices**: Selecting a device is what makes this integration read it. A device marked "not supported yet" has no parser here, so it produces two diagnostic sensors and nothing else. Leaving it selected is still worth doing, because a diagnostics download from it attached to a GitHub issue is what support for a new model is built from. Switch the diagnostic data recording below on first and download afterwards, because with account sign-in the download does not carry that raw data on its own. - **Record extra diagnostic data for 24 hours**: Keeps more of the raw messages your devices send, records any device this integration does not support yet, and records the settings the EcoFlow app writes to your devices while it runs. That last one is how a control gets built for a model nobody here owns: changing the setting in the app once, with this on, shows what the device accepts. Only worth switching on if it was asked for in a GitHub issue, since the data is only useful attached to a diagnostics download. Nothing is ever sent to your devices, and the recording stops by itself after 24 hours. - **Track completed PowerPulse charging energy by vehicle**: Reads completed charging sessions from your EcoFlow account about every 5 minutes and keeps a local record of them in Home Assistant. The record is removed when you delete the integration. Texts from the code of [shuette42/ecoflow-energy-ha](https://github.com/shuette42/ecoflow-energy-ha). ## Entities - **Binary sensors**: AC Enabled, DC Output Enabled, 12V Enabled, UPS Enabled, Relay, AC Outlet 1, AC Outlet 2, AFCI Fault String 1, AFCI Fault String 2, Battery Line Disconnected, Battery Relay Fault, SG Ready Enabled, and 33 more - **Buttons**: Wallbox Start Charging, Wallbox Stop Charging - **Numbers**: AC Charge Speed, Max Charge SoC, Min Discharge SoC, Backup Reserve, Solar Surplus Threshold, Heating Rod Target Power, Heating Rod Target Temperature, Standby Timeout, 12V Port Timeout, Screen Brightness, Screen Timeout, Backup Reserve Level, and 37 more - **Selects**: Work Mode, Heating Rod Mode, Screen Timeout, Device Idle Shutdown, AC 1 Idle Shutdown, AC 2 Idle Shutdown, 12 V Idle Shutdown, Operating Mode, Operating Submode, Display Temperature, Mood Light, Wallbox Charging Mode, and 1 more - **Sensors**: SoC, Input Total, Output Total, Solar Input 1, Solar Input 2, 12V Output, AC Output 1, AC Output 2, Type-C 3, Solar Power, Third-Party Solar Power, and 734 more - **Switches**: AC Output, DC Output, 12V Output, Beeper, X-Boost, AC Auto Restart, Backup Reserve, Plug, AC output, AC output 2, 12V output, and 36 more ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. ## From the README > Real-time solar, battery, grid & home power monitoring. Energy Dashboard ready. Two cloud modes: official API or real-time app connection. Plus a local Modbus connection for the three-phase PowerOcean. > > - In the HACS default store - installable from HACS directly, no custom repository to add > - Up to 253 sensors on one device - power, energy, battery packs, temperature, diagnostics > - Energy Dashboard ready - local Riemann-sum kWh with gap detection > - Real-time out of the box - Enhanced Mode: ~2-4 s updates for most devices > - Local option for a three-phase PowerOcean - Modbus/TCP on your own network, about every 2 s, no account and no cloud > - Full PowerOcean control - Backup Reserve, Solar Surplus Threshold, Work Mode (Self-use / AI Schedule) > - Delta switches & numbers - AC/DC output, charge speed, backup reserve, screen settings > - Auto-discovery - all devices bound to your EcoFlow account (cloud connections) > - Six languages - English, German, French, Italian, Dutch and Polish, for every entity name, state, setup screen and error message > - 4-tier reconnect - never gives up on the connection > - Automatic fallback - MQTT stale? Transparent switch to HTTP polling (Standard Mode) > - Offline tolerance - mobile devices offline = expected, not an error From the README of [shuette42/ecoflow-energy-ha](https://github.com/shuette42/ecoflow-energy-ha#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [Energy](https://vulpo.app/integrations/category/energy.md), Backup power - Brand: [EcoFlow](https://vulpo.app/integrations/ecoflow.md) - Number: 659 installs sharing analytics; 48 GitHub stars - Connection: Needs the vendor's cloud - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v1.26.0, last updated October 26, 2026 - Domain: `ecoflow_energy` - Source: - Issues: - Screenshot: https://vulpo.app/integrations-img/23fdb947a0e09912.webp (from shuette42/ecoflow-energy-ha's README) - Screenshot: https://vulpo.app/integrations-img/ea53607077e4ec8b.webp (from shuette42/ecoflow-energy-ha's README) In Vulpo: Quick Toggle card, Climate card, Button card, Select card, Apple Watch, Control Center, Climate Live Activity (Pro) [Widgets & Live Activities in Vulpo](https://vulpo.app/features/widgets-and-live-activities) ## Other ways in for EcoFlow | Name | Kind | Installs or stars | Connection | Upkeep | | --- | --- | --- | --- | --- | | [Ecoflow-Cloud](https://vulpo.app/integrations/marketplace/snell-evan-itt-hassio-ecoflow-cloud-us.md) | Marketplace integration | 4.3k installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months | | [EcoFlow BLE (Unofficial)](https://vulpo.app/integrations/marketplace/rabits-ha-ef-ble.md) | Marketplace integration | 1.4k installs sharing analytics | Works locally | Updated in the last 6 months | | [Ecoflow PowerOcean](https://vulpo.app/integrations/marketplace/niltrip-powerocean.md) | Marketplace integration | 270 installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months | | [EcoFlow IoT](https://vulpo.app/integrations/marketplace/michelfr-ha-ecoflow-iot.md) | Marketplace integration | 163 installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months | | [EcoFlow Ocean 2](https://github.com/jensfr1/ha-ecoflow-ocean2) | Marketplace integration | 27 installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months | Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-25. Source: https://vulpo.app/integrations/marketplace/shuette42-ecoflow-energy-ha --- - HTML version of this page: https://vulpo.app/integrations/marketplace/shuette42-ecoflow-energy-ha - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml