RuuviBridge is designed to act as a "data bridge" between various sources and consumers of data. Original design goal is to work as a drop-in replacement for RuuviCollector for users who have a Ruuvi Gateway or use ruuvi-go-gateway.

Supports following sources (sources of Ruuvi data):

• MQTT (in Ruuvi Gateway format)
• Ruuvi Gateway by polling the /history http-api endpoint
• HTTP POST (in Ruuvi Gateway format, the custom http server setting)

Supports following sinks (things that use the data):

• InfluxDB 1.8 and 2.x
• InfluxDB v3
• Prometheus
• MQTT (including Home Assistant MQTT discovery for automatic configuration)

Supports following Ruuvi Data Formats:

• Data Format 3: "RAW v1" (eg. older RuuviTag firmware)
• Data Format 5: "RAW v2" (eg. current RuuviTag firmware)
• Data Format 6: Bluetooth 4 compatible version of format E1
• Data Format E1: "Extended v1" (eg. Ruuvi Air)

Supports following data from the device (depending on hardware revision and firmware):

• Temperature (Celsius)
• Relative humidity (0-100%)
• Air pressure (Pascal)
• Acceleration for X, Y and Z axes (g)
• Battery voltage (Volts)
• TX power (dBm)
• RSSI (Signal strength at the receiver, dBm)
• Movement counter (Running counter incremented each time a motion detection interrupt is received)
• Measurement sequence number (Running counter incremented each time a new measurement is taken on the device)
• PM 1.0/2.5/4.0/10.0 (µg/m³)
• Carbon dioxide (ppm)
• VOC index (unitless)
• NOx index (unitless)
• Illuminance (lux)
• Sound levels (undocumented and currently not available on commercially available hardware revisions)

Ability to calculate following values in addition to the raw data (the accuracy of these values are approximations):

• Total acceleration (g)
• Absolute humidity (g/m³)
• Dew point (Celsius)
• Equilibrium vapor pressure (Pascal)
• Air density (Accounts for humidity in the air, kg/m³)
• Acceleration angle from X, Y and Z axes (Degrees)
• Air quality index (0-100)

Check config.sample.yml for a sample config. By default the bridge assumes to find a file called config.yml in the current working directory, but that can be overridden with -config /path/to/config.yml command line flag.

By default RuuviBridge parses the config in a flexible way, ignoring all unknown fields. This can be changed with -strict-config command line flag, which will make RuuviBridge throw errors if there are unknown entries in the config. Do note that this only validates whether the config has a valid structure with right keys (ie. no typos in the keys), it does not validate whether the config makes sense as such.

Recommended method is using Docker with the prebuilt dockerimage: ghcr.io/scrin/ruuvibridge for which you can use the provided composefile

Without docker you can download prebuilt binaries from the releases page. For production use it's recommended to set up as a service.

Home Assistant allows automatic configuration of MQTT entities using MQTT Discovery. To enable RuuviBridge to automatically configure all of your Ruuvi devices to Home Assistant for you, all you need to do (assuming default configuration) is to set homeassistant_discovery_prefix in the config under mqtt_publisher. In default Home Assistant configuration this should be simply homeassistant.

After setting this configuration, it should be a matter of seconds before your Ruuvi devices should appear as devices in Home Assistant for reporting all available measurements, with properly set names, units, icons and other attributes.