Skip to content

v2.1.0 — Local gateway access (local-first control)

Choose a tag to compare

@kayloehmann kayloehmann released this 03 Jul 17:31
Immutable release. Only release title and notes can be modified.

✨ New: Local gateway access (preview)

Talk to the GARDENA smart Gateway directly over your LAN, alongside the cloud. When enabled and reachable, local state takes precedence over the cloud and commands are sent locally first — the cloud stays as an automatic fallback. Lower latency, and monitoring/control keep working during a cloud or internet outage. Built on the official gardena-smart-local-api (GARDENA GmbH).

Setup

  1. One-time on the gateway (via shell): enable its local WebSocket service —
    touch /etc/enable-websocketd · systemctl restart firewall · systemctl start websocketd.
  2. In Home Assistant: Settings → Devices & Services → Gardena → Configure → enable local gateway access, host/IP (e.g. 10.0.0.5 or GARDENA-xxxxxx.local), password (the first 8 characters of the gateway's device id), port (default 8443).

New entities

  • Local gateway connected — connectivity binary sensor
  • Last command via (local / cloud) — per-device diagnostic sensor

Notes

  • The gateway sends no initial state snapshot, so the cloud still provides the initial device state after a restart; local is a live-update + command overlay.
  • Home Assistant must be able to reach the gateway on TCP 8443 (same VLAN or a firewall allow rule).
  • Self-signed gateway certificate (verification disabled for it).

Quality

  • 100% test coverage, mypy --strict clean, ruff clean, Platinum scale maintained. Read + write path validated live against real hardware.

See #44 for the full change.