Skip to content


Repository files navigation


RuuviCollector is an application for collecting sensor measurements from RuuviTags and storing them to InfluxDB. For more about how and for what this is used for, see this post.

Do you have a Ruuvi Gateway? You might be insterested in RuuviBridge instead. You can also use ruuvi-go-gateway if you want to upgrade to the "new stack" without needing a physical Ruuvi Gateway, or want to use a mix of both.

Note: This tool is primarily intended for advanced users, so some knowledge in Linux and Java might be necessary for fully understanding how to use this. However there is a more beginner friendly setup "guide" here


Supports following RuuviTag Data Formats:

  • Data Format 2: Eddystone-URL, URL-safe base64 -encoded, kickstarter edition
  • Data Format 3: "RAW v1" BLE Manufacturer specific data, all current sensor readings
  • Data Format 4: Eddystone-URL, URL-safe base64 -encoded, with tag id
  • Data Format 5: "RAW v2" BLE Manufacturer specific data, all current sensor readings + extra

Additionally basic support for iBeacon and Eddystone exists:

  • iBeacon: MAC, RSSI and other receiver-side generated data
  • Eddystone UID: MAC, RSSI and other receiver-side generated data
  • Eddystone TLM: temperature, battery voltage, MAC, RSSI and other receiver-side generated data

Supports following data from the tag (depending on tag 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 tag)

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)

See for additional details about the measurements.


  • Linux-based OS (this application uses the bluez stack for Bluetooth which is not available for Windows for example)
  • Bluetooth adapter supporting Bluetooth Low Energy
  • bluez and bluez-hcidump at least version 5.41 (For running the application, versions prior to 5.41 have a bug which causes the bluetooth to hang occasionally while doing BLE scanning)
  • Maven (For building from sources)
  • JDK8 (For building from sources, JRE8 is enough for just running the built JAR)



mvn clean package


Automatic Setup

Service scripts and other necessary stuff for "properly installing" this are available in the service-setup directory.

Manual Setup

  • hcitool and hcidump require additional capabilities to be run as a normal user, so you need to execute the following commands or run the application as root
sudo setcap 'cap_net_raw,cap_net_admin+eip' `which hcitool`
sudo setcap 'cap_net_raw,cap_net_admin+eip' `which hcidump`
  • Run the built JAR-file with java -jar ruuvi-collector-*.jar
    • Note: it's recommended to run this for example inside screen to avoid the application being killed when terminal session ends
  • To configure the settings, copy the to and place it in the same directory as the JAR file and edit the file according to your needs.


The default configuration which works without a config file assumes InfluxDB is running locally with default settings, with a database called 'ruuvi'. To change the default settings, copy the file as in the same directory as the collector jar file and change the settings you want. Most up-to-date information about the supported configuration options can be found in the file.

To give human readable friendly names to tags (based on their MAC address), copy the file as in the same directory as the collector jar file and set the names in this file according to the examples there.


For built version (while in the "root" of the project):

java -jar target/ruuvi-collector-*.jar

Easily compile and run while developing:

mvn compile exec:java


Dockerized installation is possible with the bundled Dockerfile, which is particularly useful for "server-grade" installations. The Docker image can be built with for example:

docker build -t ruuvi-collector .

Note: if you have configuration files present in the current directory, they will be added to the built image. Alternatively they can be mounted inside the container while running.

Depending on the configuration, it may be necessary to use --net=host (to access the host network stack directly) and/or --privileged (to access a local BLE adapter directly), for example:

docker run --name ruuvi-collector --privileged --net=host -d ruuvi-collector


Utility to collect measurements from RuuviTags and store them in InfluxDB








No packages published