bentasker12/ecowitt_listener repository overview

⁠Ecowitt Listener

Small docker image to receive writes from weather stations using Ecowitt protocol and write the data into an upstream InfluxDB instance (OSS, Enterprise or Cloud).

⁠Examples

Writing into InfluxCloud⁠

docker run -d \
-p 8090:8090 \
-e INFLUX_URL="https://eu-central-1-1.aws.cloud2.influxdata.com" \
-e INFLUX_ORG="[email protected]" \
-e INLUX_TOKEN="====" \
-e INFLUX_BUCKET="weather" \
bentasker12/ecowitt_listener

Writing into an unauthenticated Influx 1.x instance

docker run -d \
-p 8090:8090 \
-e INFLUX_URL="http://myinfluxinstance:8086" \
-e INFLUX_BUCKET="weather" \
bentasker12/ecowitt_listener

Writing into an authenticated Influx 1.x instance

docker run -d \
-p 8090:8090 \
-e INFLUX_URL="http://myinfluxinstance:8086" \
-e INFLUX_BUCKET="weather" \
-e INLUX_TOKEN="ben:secretpassword" \
bentasker12/ecowitt_listener

Writing into an OSS 2.x instance

docker run -d \
-p 8090:8090 \
-e INFLUX_URL="http://myinfluxinstance:8086" \
-e INFLUX_ORG="[email protected]" \
-e INLUX_TOKEN="====" \
-e INFLUX_BUCKET="weather" \
bentasker12/ecowitt_listener

⁠Configuration Options

The default configuration is set to suit me, so may not suit you.

The following environment variables can be exported to control behaviour

• IGNORE: Which fields in the input should be skipped (default: "PASSKEY,stationtype,dateutc,freq")
• TAGS: Which fields in the input should be converted to tags (default: "model")
• MEASUREMENT: Name of the measurement to write into (default: "weather")
• DEBUG: Set non-empty to enable debugging
• RAIN_MM: Convert rain from Inches to MM (Default: "yes")
• PRESSURE_HPA: Convert pressure readings to HPA (Default: "yes")
• TEMP_C: Convert temperature readings to Centigrade (Default: "yes")
• SPEED_KPH: Convert speed to KPH (Default: "no")

More information is available in the source repo⁠

⁠Examples and more

There's a post at https://www.bentasker.co.uk/posts/blog/house-stuff/receiving-weather-info-from-ecowitt-weather-station-and-writing-to-influxdb.html⁠ which gives more detail on how to stand this up, as well as integrate it with WOW