# Marstek Offline Endpoint: reconstructing Venus cloud replies

> Marstek Offline Endpoint recreates the telemetry upload and time replies expected by Marstek Venus E and D batteries on a local server. The author traces firmware conditions behind network resets, implements the response path in a container and records uploaded measurements locally. The author reports that a Venus D on Control firmware v150 stopped its periodic network interruptions during the documented observation.

- Type: Case study
- Targets: Firmware · Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-08
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/sphings79/Marstek-offline-endpoint>
- Primary source: <https://github.com/sphings79/Marstek-offline-endpoint/blob/faea0bde5547a181ac20c500efb1f32a86e71343/README.md>
- Catalog page: <https://awesomerea.org/resources/marstek-offline-endpoint-case/>
- Record JSON: <https://awesomerea.org/resources/marstek-offline-endpoint-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/marstek-offline-endpoint-case/index.md)

## Requirements & limits

- **Prerequisites:** A Marstek Venus battery, a local Docker host with ports 80 and 443 available, and DNS or traffic redirection to that host.
- **Prerequisites:** Set TZ to the device's local time zone for time replies.
- **Testing evidence:** The v151 behavior is based on decompiled code and has not been measured on a v151 device.
- **License:** MIT License.

## Primary sources

1. <https://github.com/sphings79/Marstek-offline-endpoint/blob/faea0bde5547a181ac20c500efb1f32a86e71343/README.md>
2. <https://github.com/sphings79/Marstek-offline-endpoint/blob/faea0bde5547a181ac20c500efb1f32a86e71343/docs/HOW-WE-FOUND-IT.md>

## More in Firmware and hardware

- [ZTE ZXSLC SR1010: analysing configuration and NAND firmware](https://awesomerea.org/resources/zte-sr1010-research-case/index.md) · Case study
- [esphome-quietcool: reconstructing QuietCool fan radio control](https://awesomerea.org/resources/esphome-quietcool-case/index.md) · Case study
- [QuietCool ESPHome: reconstructing IT-AF-SMT BLE control](https://awesomerea.org/resources/quietcool-esphome-native-case/index.md) · Case study
- [ReadyNAS RN426: reconstructing front-panel control under TrueNAS](https://awesomerea.org/resources/truenas-rn426-panel-case/index.md) · Case study
- [Dahua IP cameras: mapping the device JSON-RPC API](https://awesomerea.org/resources/dahua-rpc-api-case/index.md) · Case study
- [GNR-SMU: mapping Ryzen SMU telemetry and controls](https://awesomerea.org/resources/gnr-smu-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.