:sunny: Sunalyzer

June 19, 2026 · View on GitHub

Sunalyzer is a free, open source and vendor independent solar monitoring system. It collects relevant data from your inverter/smart meter and stores them safely in a data base.

A modern and beautiful web frontend allows you to visualize the data on any device. The user interface is highly responsive and works great on any screen size, from a small smart phone to a huge PC monitor.

Sunalyzer can easily be self hosted on a Raspberry Pi or a NAS by using Docker. It works 100% offline, no cloud is involved. All your data stays under your control.

Screenshot

Main Features

100% free and open source.
Easy to set up and configure (e.g. on a Raspberry Pi or a NAS).
Fully local storage of collected data. No cloud or 3rd party involved.
Hardware vendor independent.
Beautiful and highly dynamic user interface. Desktop and mobile friendly.
Visualization of all important values via graphs.
Detailled information and statistics with lots of useful information.
High resolution historical data (1 minute resolution) is kept.
Very compact database: roughly 15mb of storage are required per year.
CSV download (manually or via API) of all relevant data.

Supported Languages

Currently Sunalyzer provides an English and a German user interface. The language can be changed on the fly via the user interface.

Supported Devices

Sunalyzer provides integrations for the following device types (inverters/smart meters):

Fronius (Symo/Gen24)
Sunsynk/Deye (single-phase hybrid inverters, via WiFi/LAN dongle or RS485)
Dummy device (for testing purposes)

Contributions for the support of additional devices are welcome. Please feel free to reach out to me or submit a pull request directly.

Installation instructions

Sunalyzer comes as a self contained and easy to set up Docker container. Thus it can be run on various different platforms. Detailled installation instructions for the Raspberry Pi and Synology DiskStation NAS systems are provided below.

General Instructions

Create a folder called data on your host system. This will contain the configuration file and the data base.
Create a configuration YAML file in this data folder. Use this template] as a starting point. A detailled description of the configuration elements can be found below.
Pull the latest version of the Sunalyzer Docker image from DockerHub.
Create a container based on this image.

The container exposes port 5000. Map this to a port on your host system.
The container exposes a volume called data. Map this to the data folder on your host system created in step 1.

Make sure your data folder is regularily backed up as it contains the data base!
Start the container. Done!

Using Docker Compose

If you are using Docker Compose, create and run a docker-compose.yml file like this:

services:
  sunalyzer:
    container_name: sunalyzer
    image: borisbrock/sunalyzer:latest
    restart: always
    ports:
      - "8020:5000"
    volumes:
      - /volume1/docker/sunalyzer/data:/data

Setting	Description
logging	Can be 'normal' (only basic logging) or 'verbose' (verbose logging for debug purposes).
time_zone	The time zone that will be used to generate time stamps for logged data. E.g. "Europe/Berlin".
device:type	Name of the device plugin to use. Currently "Fronius", "Sunsynk" and "Dummy" are supported.
device:start_date	The date on which the inverter first started production (YYYY-MM-DD).
prices:price_per_grid_kwh	Price for 1 kWh consumed from the grid (e.g. in €).
prices:revenue_per_fed_in_kwh	Revenue for 1 fed in kWh (e.g. in €).
server:ip	IP address of the web server. Should be set to 0.0.0.0.
server:port	Port of the web server. Should be set to 5000.
grabber:interval_s	Interval in seconds that the grabber will use to query the inverter/smart meter. Default is 3s.

Additional settings are required depending on the selected device plugin:

Fronius

Setting	Description
fronius::host_name	IP address or host name of your fronius inverter.
fronius::has_meter	True/False - Is there a Fronius smart meter present?

Sunsynk

Sunsynk/Deye single-phase hybrid inverters are read locally (no cloud) over Modbus. Two transports are supported, selected via sunsynk::connection:

solarman – talks to the inverter's WiFi/LAN data logger (the "dongle") over TCP using the Solarman V5 protocol. This is the default and needs no extra hardware.
modbus_rtu – talks directly to the inverter's RS485 port via a USB-RS485 adapter. The host serial device must be passed into the container (see below).

Setting	Description
sunsynk::connection	Transport to use: "solarman" (WiFi/LAN dongle) or "modbus_rtu" (RS485). Default "solarman".
sunsynk::mb_slave_id	Modbus slave/unit id of the inverter. Default 1.
sunsynk::host_name	(solarman) IP address or host name of the WiFi/LAN data logger.
sunsynk::logger_serial	(solarman) Serial number of the data logger (printed on the dongle).
sunsynk::port	(solarman) Solarman V5 TCP port. Default 8899.
sunsynk::serial_port	(modbus_rtu) Host serial device, e.g. /dev/ttyUSB0 (prefer /dev/serial/by-id/...).
sunsynk::baudrate	(modbus_rtu) Serial baud rate. Sunsynk default 9600.
sunsynk::parity	(modbus_rtu) Serial parity: N, E or O. Default N.
sunsynk::stopbits	(modbus_rtu) Serial stop bits. Default 1.
sunsynk::bytesize	(modbus_rtu) Serial byte size. Default 8.

Note on registers: Sunsynk/Deye Modbus register addresses and scales vary by model and firmware. Sunalyzer ships with the de-facto-standard single-phase-hybrid map, but you should verify the values against your own inverter (run with logging: verbose to see every decoded value). The register map and references are documented at the top of backend/devices/Sunsynk.py.

RS485 (modbus_rtu) and Docker: the published image does not include pymodbus, so build the image locally instead of pulling it (uncomment build: . in your compose file), pass the serial device into the container (devices: ["/dev/ttyUSB0:/dev/ttyUSB0"]), and grant access to it (group_add: ["dialout"]). See the commented RS485 section in templates/docker-compose.yml.

Deveopment Environment

Sunalyzer is currently being developed using the following tools and libraries:

Operating system: Arch Linux
Development Environment: Visual Studio Code
Programming languages: Python 3.12, JavaScript, HTML
Database: SQlite
Frameworks: Bootstrap, Chart.js, hammer.js, Fontawesome
DevOps: flake8, pytest, htmlhint, ESlint
Deployment: Docker