Skip to content

silenthooligan/localsky-ha

Repository files navigation

LocalSky

LocalSky for Home Assistant

Your backyard weather station and smart irrigation, as native Home Assistant entities.
Discovered automatically. Updated in under a second. No YAML.

Validate Release HACS HA 2024.11+ License: Apache-2.0

LocalSky is a local-first hyperlocal weather and irrigation engine that runs as one container on your LAN. This integration is the bridge: it finds your LocalSky, subscribes to its live streams, and turns everything it knows into Home Assistant entities you can automate against.

Full setup guide: localsky.io/docs/hacs

Why you'll like it

  • Instant. State arrives over server-sent events, not polling. A zone starts watering and Home Assistant knows in under a second.
  • Zero config. LocalSky announces itself on the network; Home Assistant offers to add it. Pair, done.
  • Grows with the server. Entities are driven by LocalSky's own manifest. Add a zone or a sensor in LocalSky and it appears in Home Assistant, no integration update, no restart.
  • Complete control. Open and close zone valves, suspend irrigation, tune skip thresholds, and call run_zone / stop_zone / stop_all services from automations.
  • Secure by default. Instances with authentication enabled pair with an API token, and a guided reauth flow handles rotation.
  • Multi-instance. Test bed and production, or one per property. Each instance is its own device.

What you get

Surface Entities
Weather A full weather entity (conditions + daily forecast) backed by your own station
Station Temperature, feels like, humidity, dew point, wind speed/gust/direction, pressure, rain today, rain intensity, solar, UV, lightning, station battery
Engine Today's run/skip verdict and reason, days since rain, ET0, water level, heat multiplier, rain probability
Per zone Soil moisture, soil temperature, EC, probe battery, soil bucket, planned run, minutes run today, running state, and a valve
Controls Irrigation suspend switch, rain/wind/freeze threshold numbers
Services localsky.run_zone, localsky.stop_zone, localsky.stop_all

Install

One click (opens your own Home Assistant):

Open your Home Assistant instance and add this repository to HACS

Install LocalSky when HACS opens, then restart Home Assistant.

Or by hand: HACS, three-dot menu, Custom repositories, add https://github.com/silenthooligan/localsky-ha as category Integration, install, restart. (Default-catalog inclusion is pending review; until then the repository adds as a custom one either way.)

Pair

If LocalSky is already running on your LAN, Home Assistant discovers it and prompts you. Otherwise:

Open your Home Assistant instance and start setting up a new integration

Enter the host and port (default 8090). Instances with auth enabled will ask for an API token, created in LocalSky under Settings, Account.

Requirements

  • Home Assistant 2024.11 or newer
  • A reachable LocalSky 0.2.0 or newer

No LocalSky yet?

This integration is the bridge; it needs a running LocalSky server to pair with. The integration itself works on every Home Assistant installation type, but how you run the server depends on yours (check Settings > About, the Installation method line):

  • Home Assistant OS or Supervised: install the server as a Home Assistant app, one click and it runs right next to HA, and this integration then discovers it automatically. The app store only exists on these two installation types:

    Add the LocalSky app repository to my Home Assistant

  • Container or Core (no app store), or any other machine on your LAN: run the server with Docker, it is one container. Docker is the preferred way to run LocalSky overall; the app above is the same image packaged for HAOS convenience.

Contributing

Bug reports and PRs welcome. Engine, weather source, or controller issues belong on the main LocalSky repo; config flow, entity, or pairing issues belong here.

License

Apache-2.0. See LICENSE.

About

Home Assistant integration for LocalSky: every reading, zone valve, forecast, and watering control as native HA entities.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages