Skip to content

Home

Jump to bottom
Ravi Singh edited this page May 23, 2026 · 4 revisions

TankSync

Reliable smart water monitoring. Engineered to be reliable, not just smart.

A solar-powered sensor on the rooftop, a quiet hub on the wall, and smart water monitoring that keeps working even when the internet doesn't. Up to 6 tanks per hub. Reports to your phone via the optional PWA, to Home Assistant via HACS, or to any MQTT broker. Local operation is the default; cloud is opt-in.

Why this matters: most "smart tank" products treat the cloud as the product. TankSync treats reliability as the product. The hub, sensor, local web UI, OLED display, LED ring, buzzer, and Home Assistant integration all work without an account, without an ISP, without us. The cloud, when you opt in, is an enhancement — never a dependency.

The whole system is open at the core — firmware (AGPL-3.0), hardware (CC BY-SA 4.0), schematics, STL cases, BOM, and flashing tools are all in this repository. Self-host it. Fork it. Audit it.

Pick your path

You want to... Start here
Buy a ready-made kit smartghar.org/tanksync
Build one from scratch Hardware Build → Quick Start
Flash an existing board Quick Start (browser flasher, no toolchain)
Add a TankSync hub to Home Assistant HACS Integration
Just understand how it works How TankSync Works
Troubleshoot something FAQ → Troubleshooting

What's in the box (or on your printer)

flowchart LR
    TX[TX node<br/>solar + 18650] -->|LoRa| RX[RX hub<br/>USB-C]
    RX -->|Wi-Fi + MQTT| App[Phone / HA / dashboard]
Loading
  • TX — one per tank. Custom circular PCB, PETG enclosure, solar panel, JSN-SR04T ultrasonic sensor. Sleeps between readings; runs years on a single 18650.
  • RX — one per property. ESP32 hub on USB-C. Local web UI, OLED, optional LED strip + buzzer, MQTT bridge.
  • App — open the PWA in any browser, or wire it into Home Assistant via the HACS integration.

Documentation map

Build → Hardware Build · Bill of Materials · Wiring (Hub) · Wiring (Transmitter) Flash + first boot → Quick Start · Browser Flasher · First Boot Use → HACS Integration · PWA Walkthrough · Local Web UI Reference → FAQ · Troubleshooting · Firmware Versions

License

  • Firmware — AGPL-3.0
  • Hardware (schematics, PCB, STL, BOM) — CC-BY-SA 4.0
  • Brand — "TankSync" and "SmartGhar" are trademarks of Ravi Singh / TechPosts Media

You can build it, modify it, and sell it. Derivative firmware must stay open under the AGPL; derivative hardware must stay open under CC-BY-SA. The brand names are reserved.

TankSync

Start here

Build it

Flash it

Use it

Reference

Main repo → HACS repo →

Clone this wiki locally