Installation

Installation

How to install the SmartGhar HACS integration on Home Assistant. The whole flow happens locally on your home network — no SmartGhar account, no cloud anywhere in the HA path.

Prerequisites

• A SmartGhar Hub (TankSync) on firmware rx-v2.7.0 or newer, claimed via the SmartGhar PWA, and connected to your home Wi-Fi
• Home Assistant 2024.1.0 or newer (any flavor: HAOS, Container, Supervised, Core)
• HACS installed — see HACS prerequisites if you haven't done that
• HA and the hub on the same network — see Multi-Hub-Setup if they're separated by VLAN

Step 1 — Add the custom repository

Until the integration is submitted to HACS default repos, install via custom repository:

1. HACS → Integrations → ⋮ (top right) → Custom repositories
2. Paste the URL:

   https://github.com/Techposts/smartghar-homeassistant
   

3. Category: Integration → click Add
4. Search HACS for "SmartGhar" → click the card → Download

Step 2 — Restart Home Assistant

Settings → System → Restart Home Assistant

This is required — HA reads each integration's manifest.json zeroconf list only at startup, so the auto-discovery filter for _smartghar._tcp doesn't activate until you restart.

Step 3 — Add your hub

Two paths.

Auto-discovery (preferred)

After the restart, your Settings → Devices & Services page should show a new "Discovered" card at the top:

🔔 SmartGhar Hub discovered — Configure

Click Configure → Submit. Done.

If discovery doesn't fire, see Troubleshooting#auto-discovery-doesnt-fire — the most common reason is HA running in a Docker container with bridge networking that blocks multicast. Use manual entry instead.

Manual entry

Settings → Devices & Services → Add Integration → SmartGhar

Enter the hub's IP address (find it in the hub's local web UI System tab, your router's DHCP table, or by running dns-sd -B _smartghar._tcp on a Mac on the same LAN).

Leave Local API token blank unless you've enabled token auth on the hub web UI.

Step 4 — Verify entities populate

Settings → Devices & Services → SmartGhar → click your hub. You should see:

• One device card for the hub (manufacturer: SmartGhar, model: TankSync Hub, firmware version)
• One sub-device per attached tank, linked to the hub via HA's via_device
• Sensors for level, voltage, LoRa signal, connection state on each tank
• Editable entities: tank name, capacity, LED brightness
• Buttons: Identify Hub, Identify Tank, Restart Hub, Check for firmware updates
• Update entity in HA's sidebar Updates section

Tank readings populate after the next TX wake (~3 minutes).

Multiple hubs

Each hub auto-discovers independently. After adding one, the second hub will appear as a separate "Discovered" card. Add each one — they show up as separate device cards under SmartGhar.

See Multi-Hub-Setup for naming conventions, area assignment, and dashboard examples.

What if my hub's IP changes?

DHCP renewals are handled automatically. The integration stores the hub's IP, and when the hub re-broadcasts via mDNS (typically on boot or WiFi reconnect), HA's zeroconf integration updates the stored IP transparently — usually within an hour without any action from you.

Updating to a new version

HACS → ⋮ → Reload data        ← forces an immediate version-check
HACS → SmartGhar card → Update available → Install
Settings → System → Restart Home Assistant

You should see the new version in the integration's device card after restart. The CHANGELOG describes what changed.

Uninstalling

HACS → SmartGhar → ⋮ → Remove
Settings → Devices & Services → SmartGhar → ⋮ → Delete  (if entry persists)
Settings → System → Restart Home Assistant

Uninstalling does not affect the hub itself or the SmartGhar PWA; both continue to work normally.