Skip to main content
WeatherXM
Open Technology / Home Assistant

Use a WeatherXM D1 with Home Assistant over your local network.

Yes, a WeatherXM D1 streams live weather straight into Home Assistant on your LAN. Its WG1200 gateway runs a built-in HTTP REST API (/api/v1/observations) and announces itself via mDNS (_weatherxm._tcp.local.). The local API needs no cloud account or internet connection, and works on both Network Edition and Open Edition.

Both editions include the local API — Network Edition is the lower-priced entry point unless you want zero network participation commitment. D1 ships from our EU warehouse; US orders may incur import duty on arrival (shipping details).

Buy D1 Network · $199 ↗ Open Edition · $299 ↗ Set up in 5 minutes ↓
WG1200 local web console on the LAN, showing pairing, radio settings and live decoded weather packets
WG1200 local web UI on your LAN: live decoded station packets, API explorer and built-in Home Assistant YAML generator.
HTTP REST
local API built into the gateway
mDNS
automatic LAN discovery
0
cloud accounts needed for local reads
≈20 s
station-to-gateway packet interval
Before You Start

Three things, all on your own network.

01 · Hardware

WeatherXM D1

Solar outdoor weather station paired with the indoor WG1200 gateway, a 4-inch touchscreen console powered over USB-C next to your router.

02 · Firmware

Gateway firmware v0.8.39

Check your current version via /api/v1/info. New gateways update over the air; to update immediately over USB, select WeatherXM gateway mode in the browser flasher.

Open the WG1200 flasher ↗
03 · Home Assistant

Same local network

Home Assistant must be able to reach the gateway's LAN IP on HTTP port 80 (mDNS auto-discovery works on the same subnet; manual IP works across VLANs or VPNs).

Standalone Meshtastic and MeshCore firmware modes replace the gateway application and its HTTP REST API. Keep the gateway in WeatherXM gateway mode for Home Assistant.

Option A · Community HACS Integration

Install WeatherXM Gateway Local from HACS

Zero YAML. Home Assistant discovers the gateway on your LAN and creates weather and diagnostic entities automatically, including multi-gateway setups.

  1. 01

    Search for WeatherXM

    In Home Assistant, open HACS → Integrations and search for WeatherXM. If the integration you want isn't in the default list yet, add its GitHub URL under ⋮ → Custom repositories as an Integration.

  2. 02

    Install and restart

    Install the integration from HACS, then restart Home Assistant so it loads cleanly.

  3. 03

    Add your gateway

    Home Assistant discovers _weatherxm._tcp.local. automatically. Or add it manually via Settings → Devices & services using your gateway's IP and port 80.

TemperatureFeels likeHumidityPressureWind speed & gustWind directionRain rateDaily, 24 h & lifetime rainUV indexSolar irradianceSignal & firmware diagnostics
Option B · Core Home Assistant Only

Use Home Assistant's built-in REST sensor

Prefer zero custom components? Open http://<gateway-ip>/ on your network, switch to the API tab and copy the YAML generated directly by the gateway for your chosen units. Or paste the metric configuration below into configuration.yaml and replace 192.168.1.50 with your gateway's IP.

Values follow the gateway's active display units. Set metric units (°C, hPa, m/s, mm) in the gateway web UI to match this example, or use the gateway's built-in generator.

rest:
  - resource: "http://192.168.1.50/api/v1/observations"
    scan_interval: 30
    timeout: 10
    sensor:
      - name: "WeatherXM Temperature"
        unique_id: weatherxm_local_temp
        value_template: "{{ value_json.temp }}"
        availability: "{{ value_json.has_weather == true }}"
        unit_of_measurement: "°C"
        device_class: temperature
        state_class: measurement
      - name: "WeatherXM Feels Like"
        unique_id: weatherxm_local_feels_like
        value_template: "{{ value_json.feels_like }}"
        availability: "{{ value_json.has_weather == true }}"
        unit_of_measurement: "°C"
        device_class: temperature
        state_class: measurement
      - name: "WeatherXM Humidity"
        unique_id: weatherxm_local_humidity
        value_template: "{{ value_json.humidity }}"
        availability: "{{ value_json.has_weather == true }}"
        unit_of_measurement: "%"
        device_class: humidity
        state_class: measurement
      - name: "WeatherXM Pressure"
        unique_id: weatherxm_local_pressure
        value_template: "{{ value_json.pressure }}"
        availability: "{{ value_json.has_weather == true }}"
        unit_of_measurement: "hPa"
        device_class: atmospheric_pressure
        state_class: measurement
      - name: "WeatherXM Wind Speed"
        unique_id: weatherxm_local_wind_speed
        value_template: "{{ value_json.wind_speed }}"
        availability: "{{ value_json.has_weather == true }}"
        unit_of_measurement: "m/s"
        device_class: wind_speed
        state_class: measurement
      - name: "WeatherXM Wind Gust"
        unique_id: weatherxm_local_wind_gust
        value_template: "{{ value_json.wind_gust }}"
        availability: "{{ value_json.has_weather == true }}"
        unit_of_measurement: "m/s"
        device_class: wind_speed
        state_class: measurement
      - name: "WeatherXM Wind Direction"
        unique_id: weatherxm_local_wind_dir
        value_template: "{{ value_json.wind_dir_deg }}"
        availability: "{{ value_json.has_weather == true }}"
        unit_of_measurement: "°"
        state_class: measurement
      - name: "WeatherXM Rain Rate"
        unique_id: weatherxm_local_precip_rate
        value_template: "{{ value_json.precip_rate }}"
        availability: "{{ value_json.has_weather == true }}"
        unit_of_measurement: "mm/h"
        device_class: precipitation_intensity
        state_class: measurement
      - name: "WeatherXM Rain Today"
        unique_id: weatherxm_local_precip_daily
        value_template: "{{ value_json.precip_daily }}"
        availability: "{{ value_json.has_weather == true }}"
        unit_of_measurement: "mm"
        device_class: precipitation
        state_class: measurement
      - name: "WeatherXM UV Index"
        unique_id: weatherxm_local_uv
        value_template: "{{ value_json.uv }}"
        availability: "{{ value_json.has_weather == true }}"
        state_class: measurement
      - name: "WeatherXM Solar Irradiance"
        unique_id: weatherxm_local_irradiance
        value_template: "{{ value_json.irradiance }}"
        availability: "{{ value_json.has_weather == true }}"
        unit_of_measurement: "W/m²"
        device_class: irradiance
        state_class: measurement

Restart Home Assistant (or reload REST entities under Developer tools → YAML) and all eleven sensors appear under Settings → Entities.

Local API Reference

Endpoints on every WG1200 gateway

Query the same endpoints from Node-RED, scripts or local AI assistants.

Endpoint What it returns
GET /api/v1/observations Latest decoded weather: temperature, feels-like, humidity, pressure, wind speed/gust/direction, rain rate, daily/24 h/lifetime rain, UV index, solar irradiance
GET /api/v1/info Gateway model, current firmware version, unit configuration, Wi-Fi state and paired station summary
GET /status System health, uptime, microSD status and latest observation summary
GET /llms.txt Plain-text API summary and YAML snippets for AI assistants and automation tools
Inspect WG1200 gateway firmware on GitHub ↗
Why D1 for Home Assistant

A finished outdoor station with a local API built in.

  • ✓Local by default. Both Network Edition and Open Edition serve the LAN REST API with no cloud bridge or extra logger.
  • ✓Outdoor unit stays off Wi-Fi. Sub-GHz LoRa point-to-point links the solar outdoor station to your indoor gateway.
  • ✓4-inch touchscreen console. Read live local weather indoors at a glance even without opening Home Assistant.
  • ✓Local microSD logging. View 24-hour trends in the gateway web UI and archive CSV logs locally.

Deploying ten or more stations across sites? Talk to us →

Network Edition
$199

Lower-priced entry point. Includes the full local Home Assistant API and also contributes observations under WeatherXM Network rules when online.

Buy Network Edition ↗
Open Edition
$299

Same hardware and same local Home Assistant API, with zero WeatherXM Network participation commitment.

Buy Open Edition ↗
Other WeatherXM Hardware

Using H2 LoRaWAN or waiting for D2?

H2 LoRaWAN 🇺🇸 Ships from US stock in the US

Bridge LoRaWAN into Home Assistant via MQTT

H2 has no built-in Wi-Fi gateway or local HTTP API. It reaches Home Assistant through your LoRaWAN network server (a self-hosted ChirpStack instance keeps traffic local) and MQTT. Requires LoRaWAN coverage or your own gateway.

D2 Mesh COMING SOON · CROWD SUPPLY

Upcoming open-first mesh weather system

D2 Mesh is our upcoming remote mesh weather system on Crowd Supply. Check the product page for current release specifications and schedule.

FAQ

Home Assistant & local API questions

Does the local Home Assistant feed need a cloud account or internet connection?

No. Home Assistant reads observations directly from the WG1200 gateway on your local network over HTTP. No WeatherXM account or internet connection is required for the local feed.

Does local access work on the Network Edition?

Yes. Both D1 editions include the local web console and HTTP REST API. Network Edition costs less because the station also contributes observations under WeatherXM Network rules when it is online; Open Edition is for running with no participation commitment.

How often does the data update?

The outdoor station transmits a weather packet to the indoor gateway about every 20 seconds. Polling every 30 seconds from Home Assistant keeps sensors current without overloading the gateway.

Which WeatherXM station should I buy for Home Assistant?

D1 is the direct fit: its WG1200 gateway serves the local HTTP REST API on your LAN and announces itself over mDNS. If you already operate a local LoRaWAN network server such as ChirpStack, H2 can bridge decoded payloads into Home Assistant over MQTT.

How do I check or update my WG1200 gateway firmware?

Request GET http://<gateway-ip>/api/v1/info to read your current firmware version. New gateways update over the air, or you can update immediately over USB at flasher.weatherxm.com/wg1200 in WeatherXM gateway mode (target release v0.8.39).

Local Weather Infrastructure

Your yard's weather, inside Home Assistant.

A solar outdoor station, a 4-inch touchscreen console indoors, and a local HTTP REST API on your LAN.