Skip to content

Installation

Jump to bottom
Marcin edited this page May 23, 2026 · 1 revision

Installation

Prerequisites

Before you install, make sure you have:

  1. A Sunsynk account at home.sunsynk.net (or a Deye/Inteless account at pv.inteless.com)
  2. Your inverter connected to the Sunsynk cloud — the dongle LED should be green and data should be visible in the Sunsynk app
  3. Your inverter serial number — visible in the Sunsynk app under Device → About or in the web portal URL
  4. No MFA on your Sunsynk account — multi-factor authentication is not supported by the API. Disable it before setting up the integration.

Option A — HACS (recommended)

HACS (Home Assistant Community Store) handles installation and future updates automatically.

  1. Open HACS in your Home Assistant sidebar
  2. Click the three-dot menu (⋮) in the top-right corner → Custom repositories
  3. Paste the repository URL: 
    https://github.com/MarcinG81/SunSynk_HA_Integration
  4. Set Category to Integration → click Add
  5. Find SunSynk HA Integration in the HACS list → click Download
  6. Restart Home Assistant (Developer Tools → Restart, or Settings → System → Restart)
  7. Continue to Configuration

Updating via HACS

HACS will notify you when a new version is available. Go to HACS → Integrations → SunSynk HA Integration → Update. A HA restart is required after updating.

Option B — Manual install

  1. Download or clone the repository: 
    git clone https://github.com/MarcinG81/SunSynk_HA_Integration.git
  2. Copy the custom_components/sunsynk/ folder into your HA configuration directory: 
    config/
└── custom_components/
    └── sunsynk/
        ├── __init__.py
        ├── manifest.json
        ├── config_flow.py
        ├── coordinator.py
        ├── const.py
        ├── sensor.py
        ├── number.py
        ├── switch.py
        ├── text.py
        ├── helpers.py
        ├── dashboard.py
        ├── strings.json
        ├── translations/
        │   └── en.json
        ├── api/
        │   ├── __init__.py
        │   ├── auth.py
        │   └── client.py
        └── www/
            └── sunsynk-power-flow-card.js
  3. Restart Home Assistant
  4. Continue to Configuration

Updating manually

Pull the latest version and copy the updated custom_components/sunsynk/ folder again, then restart HA.

Verifying the install

After restarting HA, go to Settings → Devices & Services → Add Integration and search for Sunsynk. If it appears in the list, the installation was successful.

If it doesn't appear, check Settings → System → Logs for any errors mentioning sunsynk.

Clone this wiki locally