How To Use Ecowitt with Home Assistant

Integrating Ecowitt weather stations and sensors with Home Assistant is a fantastic way to bring your local weather and environmental data into your smart home system. In this guide, you’ll learn which Ecowitt models are supported, the pros and cons of the integration, and a straightforward step‑by‑step guide showing the setup process..

Supported Ecowitt Devices

Home Assistant’s built‑in Ecowitt integration works with any Ecowitt gateway (the GW series) or display console that supports DIY upload. These include the following:

• All GWxxxx gateways
• HP2550 / HP2560 TFT‑panel consoles
• WS2910, WS2320 and similar solar‑powered stations
• WH5360 and other upload‑capable display stations

Any sensors connected to these (wind, rain, UV, soil moisture, PM2.5, CO₂, lightning, etc.) will appear automatically in Home Assistant.

Why Integrate with Home Assistant

• • No cloud dependencies. All data stays local
  • Centralises all smart home devices
  • Fast updates (polling 16 s)
  • Supports all Ecowitt sensors and smart devices e.g. smart irrigation
  • Native Home Assistant entities for use in dashboards and automations

Ecowitt Integration with Home Assistant Step by Step Guide

Top Tip: Its a good idea document important configuration settings. This is a bit of pain to do, but it will be useful in the future if you need to troubleshoot issues

1. Add the Ecowitt Integration

In Home Assistant, go to Settings → Devices & Services and click Add Integration.
Search for “Ecowitt”, select it and click Submit.
Copy the server details shown (URL, port, path).

2. Configure Your Ecowitt Device

You can point your Ecowitt station’s data upload to Home Assistant either in the mobile app or via the station’s web interface:

Via the Ecowitt App
Open the Ecowitt smartphone app and select your station.
Tap the menu (⋮) and choose Others → DIY Upload Servers.
Add a Custom server: enter your Home Assistant IP, port (usually 8123), and path (obtained in step 1), choose “Ecowitt” protocol and set an interval (e.g. 60 s).

NOTE: Ecowitt can only connect to Home Assistant using HTTP when using the ‘Ecowitt Protocol’. If you are using HTTPS, then change to HTTP or use a proxy.

Via the Web Interface
Open your station’s IP address in a browser and log in (default has no password).
Under Customised upload settings, enable DIY upload with the Ecowitt protocol.
Enter the Home Assistant details and save.

NOTE: Ecowitt can only connect to Home Assistant using HTTP when using the ‘Ecowitt Protocol’. If you are using HTTPS, then change to HTTP or use a proxy.

3. Verify in Home Assistant

Go back to Settings → Devices & Services and click the Ecowitt integration.
If no devices appear, use the menu (…) to Reload.
Your gateway and all connected sensors should show up as entities (e.g. temperature, humidity, wind speed, rainfall, soil moisture, PM2.5, etc.).

4. Build Dashboards & Automations

Use Home Assistant dashboard lovelace cards, such as mini‑graph, gauge and sensor cards, to visualise data.

Create automations, for example:

• Close windows when rain sensor > 0 mm
• Start irrigation when soil moisture < 30 %
• Send alerts if PM2.5 exceeds a threshold

Common Issues

Port Conflicts: If you run the Home Assistant OTBR add‑on, change the Ecowitt upload port to avoid clashes (e.g. use 8090 instead of 8081).

Integration Breaks: After major HA upgrades, if Ecowitt stops updating, reload the integration or check GitHub for patches.

Use Core Integration: Remove any old HACS‑based Ecowitt plugins and rely on the built‑in integration (added in HA 2022.9).

Conclusion

Getting Ecowitt smart devices to work in Home Assistant is much easier than you might think, thanks to the Ecowitt core integration.