Bluetooth Wifi Onboarding Package (r3onboard)

Bluetooth WiFi Onboarding is a solution developed by Remote.It to simplify the process of setting up new devices. Our product leverages Bluetooth Low Energy (BLE) technology to allow users to easily connect and configure WiFi settings. Additionally, it provides the capability to register devices with the Remote.It service.

Bluetooth WiFi Onboarding makes setting up and managing your devices simple and efficient. Experience the convenience of remote access and simplified network configuration with Remote.It.

Key Features

  • Easy WiFi Configuration: Connect via Bluetooth LE to configure WiFi settings and get your device on the network effortlessly.

  • Remote Access: Register your device with the Remote.It service.

  • Compatibility: Designed to work with Bookworm Debian packages, with a primary focus on Raspberry Pi devices.

Option 1: Use our pre built pi image

If you are using a raspberry pi you can use our prebuilt image with r3Onboard already installed. Click here for details on using the prebuilt pi image.

Option 2: Create your own image with r3onboard already installed

Manually Installing the r3onboard Debian Package

To install the r3onboard package, follow these steps:

  1. Download the Package to /tmp:

    wget -P /tmp https://downloads.remote.it/r3onboard/latest/r3onboard_all.deb
  2. Install the Package with apt:

    sudo apt update
    sudo apt install /tmp/r3onboard_all.deb
  3. Service Management:

    • The r3onboard service will start automatically on boot.

    • You can manually start the service with:

      sudo systemctl start r3onboard
  4. Create an Image:

    • Once the package is installed, you can create a system image for deployment.

    • Use your preferred imaging tool to create a backup of your system after installing r3onboard.

Automate Installing the r3onboard Debian Package

You can use tools like systemd-nspawn to mount and boot an existing system image on your own machine. You can then install the Debian package once booted with systemd-nspawn. The updateImage.sh script in the repo can be used for ideas and is how we create the raspberry pi image.

Viewing Logs

Logs can be viewing using: journalctl -u r3commission -n 100

Last updated