Raspberry Pi with Bluetooth WiFi Onboarding and Remote.It
Sharing and OrganizationsSkip to Downloads


The Raspberry Pi is a versatile microcontroller board with a variety of uses from home tinker projects to IoT and manufacturing processes. These instructions are intended as a general guide for remote access. As a general rule, if your Raspberry Pi is hosting a service which is accessible via a LAN address and port, then Remote.It can be used for access from outside the LAN without port forwarding on a public IP address.

Setting up a Raspberry Pi or other headless device on wifi can be difficult when you do not have a monitor, keyboard and mouse. This is true whether it is the first time set up or if you are planning on moving your device to another location. For example, when you are building an IoT device based on a Raspberry Pi and have developed the additional software and peripherals and ship it to a customer OR when you set up your Raspberry Pi for home automation or camera systems then relocate it to a vacation home.

Remote.It has developed an OS image with the bluetooth wifi configuration to simplify it all. This is a debian based image. It comes with everything you need and simplifies installation and registration of Remote.It software for remote access to services on this device and if desired, access to services on the LAN where this device is located via jump services.

In addition, Remote.It has packaged the BLE portion so that you can include it in your own custom image.  

Already have your Raspberry Pi set up and just need to add remote access? Follow our easy set up instructions.

Requirements to set up your Raspberry Pi:

  • Raspberry Pi
  • SD card and computer with SD card reader/writer
  • Imaging Software (Raspberry Pi Imager Software (v1.8.5) used in these instructions installed on computer with SD card reader/writer
  • A Remote.It Account (sign up here https://app.remote.it)
  • A computer or phone that you will use to set up the wifi on your Raspberry Pi

We recommend a minimum 16 GB high-quality SD card from a reputable manufacturer to ensure reliability and performance with Class 10 or UHS-1 (or better) for optimal speed. Depending on your applications, you may need a larger card with higher specifications.


Burn your Image onto the SD Card


Full Desktop Image

Raspberry Pi
WiFi Onboarding Image Headless
arm64
Remote.It Download icon
Download
Remote.It Documentation icon
Documentation
Raspberry Pi
WiFi Onboarding Image Headless
armhf
Remote.It Download icon
Download
Remote.It Documentation icon
Documentation
Raspberry Pi
arm64
CPU
-
Version
v0.1.41
Date
July 15, 2024
MD5
3ddd32aa410722d92996f28eabc27187767f32b0850532811e0cfb68ca47d61d
Raspberry Pi
armhf
CPU
-
Version
v0.1.41
Date
July 15, 2024
MD5
4a85f114d1a0106c4aa0b9951eb4824f9521b7936c7319e9480acea42d0fd5e7
Headless Image
Raspberry Pi
WiFi Onboarding Image Desktop
arm64
Remote.It Download icon
Download
Remote.It Documentation icon
Documentation
Raspberry Pi
WiFi Onboarding Image Desktop
armhf
Remote.It Download icon
Download
Remote.It Documentation icon
Documentation
Raspberry Pi
arm64
CPU
-
Version
v0.1.41
Date
July 15, 2024
MD5
ad8902a2b4464df8e963d401a4ae3e3c7c31686e3d1b4b8ad11d75a312fd99e4
Raspberry Pi
armhf
CPU
-
Version
v0.1.41
Date
July 15, 2024
MD5
7b6fb6206d22b97658a7ed6a75b7879bf436ae696f3713a5fe8de7f155cf6d62
  1. Download the image to the computer that you will be using to burn the SD card
  2. Open the Raspberry Pi Imager & insert your SD card into your reader
    1. Choose the type of Pi
    2. Choose OS (Select Use Custom and select the file you downloaded to your computer)
    3. Storage (Select the SD card)
    4. Click Next
  3. Edit OS Settings -
    1. On the General tab, set the hostname (this is the name the Raspberry Pi will use on the network and if you register it with Remote.It). Set a username and password
    2. On the Services tab, enable SSH (you can choose to use username and password which will be the same as set on the previous screen OR use a public key).
    3. Save
  4. Continue through prompts to burn the card. When finished, you can eject the card and insert it into your Raspberry Pi and power it on. It can take a few minutes for yor Raspberry Pi to boot for the first time

Set Up WiFi


The Raspberry Pi can take a few minutes (2-3 minutes) to boot for the first time because it needs to unpack the files for the operating system.

This portion must be done within the first 10 minutes of the Raspberry Pi after the Pi has finished booting up or you will need to reboot the Raspberry Pi again.

  1. Open the Remote.it Mobile App, Desktop Application or go to https://app.remote.it on a device within Bluetooth range of your Raspberry Pi
  2. Click + (Add Device)
  3. Select "Set Up WiFi"
  4. Start your scan
  5. Select the network & enter the password

WiFi is now setup on your Raspberry Pi.


Enable Remote Access Via Remote.It


After setting up wifi, you have the option to register your Raspberry Pi with Remote.It to enable remote access to it from anywhere.

  1. Click on the Register button (this will install the Remote.It package on your Raspberry Pi and register it to the account you are using
  2. Once registered, you are ready to add services for connection by clicking the + (Add Services) button below the device name.
  3. Select the service type, confirm the port
  4. Optionally name and add description
  5. Scroll down and save.

See the image below. Now you are ready to connect to this service. You need to make sure that you have the service running on the device. For example, if you choose SSH, you will need to make sure that you have SSH enabled on your Raspberry Pi.

Repeat this as many times as needed for the services you wish to connect to remotely.

Remote.It Add Service Screenshot

Ready to do more?


Other things you can do with your Pi:
  • Add Jump Services to reach IP cameras or other devices on your LAN
  • Share access to your device or to some of the services
  • Add other applications to your Pi and access them remotely like a web server or VNC
  • Create a public link to your web page
  • Need to join a different WiFi network with the same Raspberry Pi? Simply repeat the Set Up WiFi section. You will need to reboot the Raspberry Pi if it hasn't been rebooted since the last set up.
Are you a developer?

Explore our developer docs website for our open source WiFi onboarding package, image production, graphQL API and more.