EcoFlow Cloud Integration for Home Assistant

GitHub release issues - hassio-ecoflow-cloud GH-code-size GH-last-commit hacs_badge HACS validation

Inspired by hassio-ecoflow and ecoflow-mqtt-prometheus-exporter this integration uses EcoFlow MQTT Broker mqtt.ecoflow.com to monitor and control the device.

Installation

HACS installation

The quickest way to install this integration is via HACS by clicking the button below:

Add to HACS via My Home Assistant

  1. Click above to install as a custom repository via HACS
  2. Restart Home Assistant
  3. Once restart is done, use Add IntegrationEcoflowCloud.

🌍 Regional API Hosts (Important for European Users)

EcoFlow strictly separates accounts by region. If you encounter the error Account doesn't exist or incorrect password during the integration setup, verify your api_host setting:

Manual installation options

Restart Home Assistant. Once restart is done, use Add IntegrationEcoflowCloud.

Device Management

For information on how to add, remove, and configure devices, please refer to the Device Management Documentation.

EcoFlow API modes

The integration supports two EcoFlow cloud API modes. They expose different data, so the same physical device can have different entities depending on the mode selected during setup.

If an entity is missing or behaves differently from the EcoFlow app, first check the device section below for the API mode you configured. When reporting a bug, include the API mode, device model, firmware version, and a diagnostic download from Home Assistant.

Disclaimers

⚠️ Originally developed for personal use without a goal to cover all available device attributes

Current state

Devices available with private_api

ALTERNATOR (sensors: 17, switches: 1, sliders: 4, selects: 1)

Sensors

Switches

Sliders (numbers)

Selects

DELTA_2 (sensors: 47, switches: 8, sliders: 6, selects: 5)

Sensors

Switches

Sliders (numbers)

Selects

DELTA_3 (sensors: 32, switches: 8, sliders: 4, selects: 5)

Sensors

Switches

Sliders (numbers)

Selects

DELTA_3_1500 (sensors: 44, switches: 9, sliders: 4, selects: 5)

Sensors

Switches

Sliders (numbers)

Selects

RIVER_2 (sensors: 32, switches: 5, sliders: 4, selects: 5)

Sensors

Switches

Sliders (numbers)

Selects

RIVER_2_MAX (sensors: 32, switches: 5, sliders: 4, selects: 5)

Sensors

Switches

Sliders (numbers)

Selects

RIVER_2_PRO (sensors: 30, switches: 4, sliders: 4, selects: 5)

Sensors

Switches

Sliders (numbers)

Selects

RIVER_3 (sensors: 36, switches: 6, sliders: 4, selects: 5)

Sensors

Switches

Sliders (numbers)

Selects

DELTA_PRO (sensors: 71, switches: 6, sliders: 6, selects: 4)

Sensors

Switches

Sliders (numbers)

Selects

DELTA_PRO_3 (sensors: 47, switches: 8, sliders: 3, selects: 4)

Sensors

Switches

Sliders (numbers)

Selects

RIVER_MAX (sensors: 49, switches: 5, sliders: 1, selects: 3)

Sensors

Switches

Sliders (numbers)

Selects

RIVER_PRO (sensors: 47, switches: 7, sliders: 1, selects: 3)

Sensors

Switches

Sliders (numbers)

Selects

RIVER_MINI (sensors: 17, switches: 2, sliders: 1)

Sensors

Switches

Sliders (numbers)

DELTA_MINI (sensors: 39, switches: 4, sliders: 3, selects: 4)

Sensors

Switches

Sliders (numbers)

Selects

DELTA_MAX (sensors: 70, switches: 7, sliders: 5)

Sensors

Switches

Sliders (numbers)

DELTA_2_MAX (sensors: 80, switches: 7, sliders: 6, selects: 3)

Sensors

Switches

Sliders (numbers)

Selects

POWERSTREAM (sensors: 63, switches: 1, sliders: 3, selects: 1)

Sensors

Switches

Sliders (numbers)

Selects

GLACIER (sensors: 29, binary_sensors: 4, switches: 3, sliders: 3)

Sensors

Binary sensors

Switches

Sliders (numbers)

GLACIER_CLASSIC (sensors: 50, binary_sensors: 3, switches: 5, sliders: 4, selects: 2)

Sensors

Binary sensors

Switches

Sliders (numbers)

Selects

WAVE_2 (sensors: 27, sliders: 1, selects: 4)

Sensors

Sliders (numbers)

Selects

WAVE_3 (sensors: 17, switches: 2, sliders: 1, selects: 3)

Sensors

Switches

Sliders (numbers)

Selects

SMART_METER (sensors: 18)

Sensors

SMART_PLUG (sensors: 5, switches: 1, sliders: 2)

Sensors

Switches

Sliders (numbers)

STREAM_AC (sensors: 39)

Sensors

STREAM_PRO (sensors: 39)

Sensors

STREAM_ULTRA (sensors: 39)

Sensors

Devices available with public_api

DELTA Max (API) (sensors: 70, switches: 7, sliders: 5)

Sensors

Switches

Sliders (numbers)

DELTA Pro (API) (sensors: 71, switches: 6, sliders: 6, selects: 4)

Sensors

Switches

Sliders (numbers)

Selects

DELTA Pro Ultra (API) (sensors: 58, switches: 3, sliders: 4)

Sensors

Switches

Sliders (numbers)

DELTA 2 (API) (sensors: 47, switches: 8, sliders: 6, selects: 5)

Sensors

Switches

Sliders (numbers)

Selects

DELTA 2 Max (API) (sensors: 80, switches: 7, sliders: 6, selects: 3)

Sensors

Switches

Sliders (numbers)

Selects

RIVER 2 Pro (API) (sensors: 30, switches: 4, sliders: 4, selects: 5)

Sensors

Switches

Sliders (numbers)

Selects

Smart Plug (API) (sensors: 4, switches: 1, sliders: 1)

Sensors

Switches

Sliders (numbers)

PowerStream (API) (sensors: 58, sliders: 4, selects: 1)

Sensors

Sliders (numbers)

Selects

WAVE 2 (API) (sensors: 27, sliders: 1, selects: 4)

Sensors

Sliders (numbers)

Selects

Delta Pro 3 (API) (sensors: 31, switches: 8, sliders: 5, selects: 6)

Sensors

Switches

Sliders (numbers)

Selects

Power Kits (API) (sensors: 161, switches: 10, sliders: 1)

bbcin

Sensors

Switches

bbcout

Sensors

iclow

Sensors

Switches

Sliders (numbers)

bpxxx

Sensors

kitscc

Sensors

lddc

Sensors

Switches

ichigh

Sensors

Switches

ldac

Sensors

Smart Meter (API) (sensors: 23, binary_sensors: 5)

Sensors

Binary sensors

Stream AC (API) (sensors: 53, switches: 5, sliders: 1)

Sensors

Switches

Sliders (numbers)

Stream PRO (API) (sensors: 53, switches: 5, sliders: 1)

Sensors

Switches

Sliders (numbers)

Stream Ultra (API) (sensors: 53, switches: 5, sliders: 1)

Sensors

Switches

Sliders (numbers)

Stream Microinverter (API) (sensors: 14)

Sensors

Smart Home Panel (API) (sensors: 30, binary_sensors: 1, switches: 4, sliders: 4, selects: 1)

Sensors

Binary sensors

Switches

Sliders (numbers)

Selects

Smart Home Panel 2 (API) (sensors: 28, binary_sensors: 2, switches: 20, sliders: 5, selects: 2)

Sensors

Binary sensors

Switches

Sliders (numbers)

Selects

Power Ocean (API) (sensors: 23)

Sensors