GW Getting Started


  1. Turn on Ruuvi Gateway by powering it with USB-C.

    - Quickstart using Ethernet: Connect Gateway to your router with Ethernet cable, wait one minute, and you're connected using default settings. - Quickstart using Wi-Fi: Activate WPS on your router by pressing the WPS button (make sure that the WPS is active on 2.4 GHz Wi-Fi).

    - Note: Ethernet cable must not be connected before the configuration is complete if you do not want to use default settings.

  2. Start configuration by connecting to Wi-Fi hotspot "Configure Ruuvi Gateway XXXX".

    - If the browser doesn't open automatically, type into the address bar.

  3. Follow the steps in the configurator to complete the setup with your preferred settings.

  4. The Gateway is now ready to use and will send data to Ruuvi Cloud or a third-party server according to your configured settings.


Ruuvi Gateway has 4 LEDs: Green, Red, Ethernet green, and Ethernet yellow.

The green LED is on when receiving data from Bluetooth sensors and communicating with the cloud server.

If the red and/or green LEDs are blinking, it means that something is wrong. For more details, seeGW ESP32 LED.

Ethernet Yellow turns on when a cable connection is detected and blinks on data transfer. Green led turns on if Gateway operates at a faster 100 MBit/s speed instead of legacy 10 MBit/s. Most modern routers will have the green LED on at all times.


A short press of the button (for example with a paperclip) re-enables the Gateway's configuration mode.

Keeping the button pressed down for 7+ seconds triggers a factory reset which erases all user-configured settings and enables configuration mode (activates Wi-Fi hotspot). After pressing the button, you need to wait until the red LED flashes at a rate of 2.5 Hz, then release the button. After that, the Gateway will restart with the active Wi-Fi access point.

For more details, GW ESP32 Configuration page is a good place to start. If you're interested in using Ruuvi Gateway with your own server, review GW ESP32 HTTP Client and GW ESP 32 MQTT Client pages for details on how data is sent to the Internet.

Using the Gateway with your own server

If you want to use the Gateway with your own server, you can connect via MQTT or HTTP(S). The data formats are detailed on the following pages:

Using the Gateway with Ruuvi Station app

Please check the Ruuvi Station instruction page.

Last updated