https://github.com/solectrus/senec-collector

Collect SENEC battery data and push it to InfluxDB. Ready to deploy to a Raspberry Pi.
https://github.com/solectrus/senec-collector

influxdb photovoltaic raspberry-pi senec

Last synced: 5 days ago
JSON representation

Collect SENEC battery data and push it to InfluxDB. Ready to deploy to a Raspberry Pi.

• Host: GitHub
• URL: https://github.com/solectrus/senec-collector
• Owner: solectrus
• License: mit
• Created: 2020-12-19T09:28:05.000Z (about 5 years ago)
• Default Branch: develop
• Last Pushed: 2025-12-25T00:03:41.000Z (about 1 month ago)
• Last Synced: 2025-12-26T13:17:44.473Z (about 1 month ago)
• Topics: influxdb, photovoltaic, raspberry-pi, senec
• Language: Ruby
• Homepage:
• Size: 1.14 MB
• Stars: 12
• Watchers: 2
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
[![Continuous integration](https://github.com/solectrus/senec-collector/actions/workflows/push.yml/badge.svg)](https://github.com/solectrus/senec-collector/actions/workflows/push.yml)

[![Maintainability](https://qlty.sh/badges/a2bc59ed-322a-44cb-b655-1efd73ef5c55/maintainability.svg)](https://qlty.sh/gh/solectrus/projects/senec-collector)

[![wakatime](https://wakatime.com/badge/user/697af4f5-617a-446d-ba58-407e7f3e0243/project/e8426066-7e79-40d8-8d8b-583dd965720a.svg)](https://wakatime.com/badge/user/697af4f5-617a-446d-ba58-407e7f3e0243/project/e8426066-7e79-40d8-8d8b-583dd965720a)

[![Code Coverage](https://qlty.sh/badges/a2bc59ed-322a-44cb-b655-1efd73ef5c55/coverage.svg)](https://qlty.sh/gh/solectrus/projects/senec-collector)

# SENEC collector

Collect data from SENEC Solar Battery Storage System and push it to InfluxDB 2

Allows accessing a local SENEC device (V2 + V3) as well as the SENEC cloud (V4).

## Requirements

Linux machine with Docker installed

Tested on:

- Raspberry Pi 4 Model B on Raspbian GNU/Linux 10 (buster) and 11 (bullseye) and 12 (bookworm)

- Synology NAS DS220+ on DSM 7.1+

- ... and lots of other Linux machines - if it runs Docker, it should work

## Getting started

0. Decide if you want to use the SENEC cloud or a local SENEC device. If you have a SENEC.Home 4, there is no choice - this device is cloud only.

   - SENEC cloud: You need to have an account at mein-senec.de (email + password + TOTP uri for MFA)

   - Local SENEC device: You need to have a SENEC device in your house that can be reached via LAN

1. Prepare a Linux box (Raspberry Pi, Synology NAS, ...) with Docker installed

2. Make sure your InfluxDB2 database is ready (not subject of this README)

3. Prepare an `.env` file (see `.env.example`)

4. Run the Docker container on your Linux box:

   ```bash

   docker compose up

   ```

The Docker image support multiple platforms: `linux/amd64`, `linux/arm64`, `linux/arm/v7`

## License

Copyright (c) 2020-2026 Georg Ledermann, released under the MIT License