---
title: "Sunsynk / Deye Solar Inverter"
description: "Sunsynk / Deye Solar Inverter is a Marketplace integration for Home Assistant. It has 120 installs sharing analytics, needs the vendor's cloud and was last updated October 26, 2026."
canonical: "https://vulpo.app/integrations/marketplace/marcing81-sunsynk-ha-integration"
url: "https://vulpo.app/integrations/marketplace/marcing81-sunsynk-ha-integration.md"
last-updated: "2026-10-27"
version: "1.4"
---

# Sunsynk / Deye Solar Inverter

> Sunsynk / Deye Solar Inverter is a Marketplace integration for Home Assistant. It has 120 installs sharing analytics, needs the vendor's cloud and was last updated October 26, 2026.

Sunsynk / Deye Solar Inverter is a custom integration that monitors and controls Sunsynk and Deye hybrid inverters through the Sunsynk cloud API. It adds sensors for PV generation, battery state, grid import and export, and load, plus per-phase values for 3-phase systems and every MPPT string it finds. Number, switch and text entities let key inverter settings be changed from Home Assistant, such as battery thresholds, charge and discharge current, time slots and sell power limits. Optional extras include a solar forecast based on Open-Meteo, a tariff manager that charges at cheap rates and discharges at peak rates from a price sensor, and a virtual slot scheduler. One entry can cover several inverters, including parallel groups, and control actions can be limited to administrators. It needs the vendor's cloud, so the inverter must already be connected through the Sunsynk dongle, and it is set up in the UI.

Automatic summary of the README and code of MarcinG81/SunSynk\_HA\_Integration. 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=MarcinG81&repository=SunSynk_HA_Integration&category=integration)

On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=MarcinG81&repository=SunSynk_HA_Integration&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.

### Sunsynk / Deye Inverter Setup

- **API Server**
- **Sunsynk Account Email**
- **Sunsynk Account Password**
- **Inverter Serial Number(s)**: For multiple inverters: SN123456;SN789012
- **Refresh Interval (seconds)**: How often to poll the Sunsynk API (minimum 60 seconds)

### After setup

- **API Server**
- **Sunsynk Account Email**
- **New Sunsynk Account Password**: Leave blank to keep the saved password. Enter a new password after changing it in the Sunsynk or Deye portal.
- **Inverter Serial Number(s)**
- **Refresh Interval (seconds)**
- **Create and maintain Sunsynk dashboard**: Opt in to creating a Lovelace dashboard, registering the bundled card resource, and updating that dashboard on each integration reload. Disabled by default.
- **Allow only administrators to use control actions**: When ticked, the Sunsynk control actions (force charge/discharge, work mode, virtual slots) can only be run by Home Assistant administrators. Automations and scripts are unaffected. Only administrators can change this setting.
- **Latitude (Solar Forecast)**: Optional — defaults to your HA home location
- **Longitude (Solar Forecast)**: Optional — defaults to your HA home location
- **Panel Peak Power (kWp)**: Total installed panel capacity in kilowatt-peak. Leave blank to disable solar forecast.
- **Performance Ratio (0–1)**: System efficiency factor, default 0.80
- **Import/Buy Price Sensor**: Any sensor reporting electricity price (e.g. Octopus Agile, NordPool, Tibber). Leave blank to disable tariff management.
- **Export/Sell Price Sensor (optional)**: Drives discharge/sell decisions instead of the import price above — for tariffs where import and export rates aren't linked (e.g. Octopus Intelligent Go + Outgoing). Leave blank to use the import price for both.
- **Charge below price (cheap rate threshold)**: When price ≤ this value, charge the battery. Leave blank to disable cheap-rate charging.
- **Charge current at cheap rate (A)**: Battery charge current during cheap period (e.g. 100 A).

Texts from the code of [MarcinG81/SunSynk\_HA\_Integration](https://github.com/MarcinG81/SunSynk_HA_Integration).

## Troubleshooting

- **Diagnostics**: Downloads a diagnostics file to attach to a bug report.
- **Repair notices**: Notices it can show in Settings, Repairs:
  Sunsynk authentication failed

## From the README

> A native Home Assistant integration (not an add-on) for monitoring and controlling Sunsynk and Deye hybrid solar inverters via the Sunsynk cloud API.
>
> Note: This integration communicates with the Sunsynk cloud API (api.sunsynk.net or pv.inteless.com). Your inverter must already be connected to the cloud via the Sunsynk dongle/Wi-Fi stick.
>
> - Real-time monitoring — PV generation, battery state, grid import/export, load consumption
> - Multi-MPPT support — Automatically discovers all MPPT strings on your inverter
> - 3-phase support — Per-phase voltage, current and power for grid, load and inverter output
> - Writable settings — Change key inverter parameters directly from HA (battery thresholds, charge/discharge current, time slots, sell power limits, etc.)
> - Solar Forecast — Optional sensors for predicted PV yield today/tomorrow, cloud cover, precipitation and solar irradiance (GHI/DNI) via Open-Meteo (free, no API key)
> - Tariff Manager — Automatic cheap-rate charging and peak-rate discharging based on any HA electricity price sensor (Octopus Agile, NordPool, Tibber, G12, input\_number, etc.), with an optional…
> - Virtual Slot Scheduler — Up to 10 charge/discharge/idle windows per inverter, defined in Home Assistant and put onto the inverter's own timer, with Tariff Manager price decisions taking priority.…
> - Multiple and parallel inverters — One integration entry supports multiple serial numbers. A parallel group's slave is recognised and every write goes to its master

From the README of [MarcinG81/SunSynk\_HA\_Integration](https://github.com/MarcinG81/SunSynk_HA_Integration#readme), [GNU GPL v3.0](https://spdx.org/licenses/GPL-3.0.html). Shortened.

## At a glance

- Kind: Marketplace integration
- Category: [Energy](https://vulpo.app/integrations/category/energy.md), Solar and batteries
- Number: 120 installs sharing analytics; 13 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: v2.0.0, last updated October 26, 2026
- Domain: `sunsynk`
- Source: <https://github.com/MarcinG81/SunSynk_HA_Integration>
- Issues: <https://github.com/MarcinG81/SunSynk_HA_Integration/issues>
- Screenshot: https://vulpo.app/integrations-img/fd0c2d681dba414b.webp (from MarcinG81/SunSynk\_HA\_Integration's README)
- Screenshot: https://vulpo.app/integrations-img/a3cdfed71626698a.webp (from MarcinG81/SunSynk\_HA\_Integration's README)

In Vulpo: Quick Toggle card, Chart card, Apple Watch, Control Center

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-27. Source: https://vulpo.app/integrations/marketplace/marcing81-sunsynk-ha-integration

---

- HTML version of this page: https://vulpo.app/integrations/marketplace/marcing81-sunsynk-ha-integration
- 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
