remote.itPi Setup Guidelines

Getting Started

Unlike a traditional Raspberry Pi configuration, remote.itPi has been specifically designed to allow for headless configuration, meaning that it can be set up without needing to connect a monitor, keyboard, or mouse to it. Instead, all you need is a computer on the same network, with any modern browser.

Note: You may optionally connect a monitor, keyboard and mouse to your Pi to setup

Following are instructions to get your remote.itPi setup.

  1. Get your remote.itPi on your network.

    a. [Connect with ethernet](remote.itpi-setup-guidelines.md#recommended-using-ethernet) \(including POE if you have it\).
    b. [Connect with wi-fi](remote.itpi-setup-guidelines.md#using-wi-fi) \(you need to edit one file on the SD card\).
    c. Use a [monitor, keyboard and mouse](remote.itpi-setup-guidelines.md#using-a-monitor-keyboard-and-mouse-connected-to-the-raspberry-pi) connected to the RaspberryPi.
  2. Registering your remote.itPi with remote.it and setting up remote access for your other network resources.

  3. How to connect to your resources from anywhere.

1. Getting your remote.itPi on your Network

This is by far the easiest way and required if you want to use out of band management.

i. Plug the RJ-45 Ethernet cable into the Pi. If your router/switch supports POE, the Raspberry Pi 4 will power up directly from your router/switch, and you can skip to step 3. If not, user the included power supply to power up your Pi.

ii. Plug in the provided USB-C power supply to power the Raspberry Pi 4, and wait for the Pi to boot.

Using Wi-Fi

Note: if you are connecting your Raspberry Pi to the internet using an Ethernet cable, you can skip this section.

i. Insert the remote.itPi SD Card into a Windows PC or Mac. Use the computer’s file browser to open the file “wpa_supplicant.conf” on the SD Card. Edit this file to include your own Wi-Fi SSID and Wi-Fi password as follows.

ii. Navigate to the micro SD's /boot directory and open wpa_supplicant.conf in a text editor. If you don't see the /boot directory, you may need to remove the micro SD card from the slot, then re-insert it.

iii. On the line that says ssid="YOUR SSID", replace YOUR SSID with the name of your Wi-Fi network. (Example: ssid="MyWiFi123")

iv. On the line that says psk="YOUR PASSPHRASE", replace YOUR PASSPHRASE with the password for your Wi-Fi network. (Example: psk="P@ssword")

v. On the line that says country=US, replace US with your country code. A list of Wi-Fi country codes can be found here.

vi. Save the edits made to wpa_supplicant.conf on the SD Card.

Unedited wpa_supplicant.conf file on the bundled SD Card:

vii. Locate the /boot directory on your computer's file directory.

viii. Right-click the /boot directory to access the menu.

ix. Click Eject to eject the micro SD card reader from your computer.

x. You can now insert the SD Card into the Raspberry Pi and boot the Pi. It will automatically join your Wi-Fi network using the SSID and password entered in steps iii and iv.

Using a Monitor, Keyboard and Mouse connected to the Raspberry Pi

i. Insert the bundled SD Card into the Raspberry Pi. Connect an HDMI monitor, USB keyboard, and USB mouse to the proper connectors on the Pi.

ii. Power up the Pi and allow it to boot.

iii. After a minute or so you should see the Pi desktop GUI displayed on your HDMI monitor

You will see a series of pop-up dialogue messages prompting you to set up your Pi. See below.

Click the button to “Register my remote.itPi”. This will open the Chromium browser on the Pi and load the remote.itPi login screen. Minimize the browser and DO NOT attempt to register your remote.itPi until your Pi is connected to the Internet and you have completed all the standard Raspbian dialogue boxes that appear.

Click through all the dialogues that appear to set the SSH password, locale, timezone, keyboard layout, Wi-Fi connection, system software update, and finally reboot your Pi.

Move to the next section “Registering and setting up remote access”.

2. Registering and Setting-Up Remote Access

i. From a computer on the same network as the Raspberry Pi 4, open a browser and type find.remote.it into the browser’s address bar.

ii. Once your Raspberry Pi has finished booting, it should show up here and be ready for registration. If it hasn’t yet shown up, just select ‘search again’ in a couple of minutes. Once your Raspbery Pi is discovered, just hit “Register”.

iii. You will be prompted to sign-in, enter your remote.it credentials here. If you don’t yet have a remote.it account, please go to https://remote.it to create an account.

iv. Once you have signed in, you will come to the one-click setup page. This will register your Raspberry Pi to your account, and make it possible for you to remote access it from anywhere using the remote.it service. The three default methods that will be registered will be: a. SSH: a secure shell, so you can command line connect to your RPi 4 b. VNC: a remote desktop, so you can use a GUI to access your RPi 4 c. The remote.it admin screen. You can use any browser to remotely configure remote.it on your RPi 4.

Note: The initial credentials for the Raspberry Pi are the standard defaults of Username: pi Password: raspberry

v. Once the Raspberry Pi has been registered, you are now ready to set it up to be a remote access gateway to other resources on your network. Just click on “Scan Network” to start that step.

vi. Once the network scan is complete, a list of the devices on your network will be presented. Available services (application ports) can be seen if you click the down arrow.

vii. In this example, we are setting up remote access connections through the remote.itPi to a Windows remote desktop service, a Apple Mac screen share service, and a network printers administrator screen.

viii. Simply click “add” to the services you want to be able to remotely access, then you will be taken to a screen where you can customize the name and confirm the registration by selecting the check box. For the protocol, we’ll attempt to select the correct on (based on the port selected) but if you are doing a custom configuration you can manually select this as well. If unsure, just select TCP, since all Internet services will work with that selection.

ix. Once you’ve finished registering the remote access you want, you are ready to test that you can get to your devices.

3. Connecting to your Resources from Anywhere

Here is an overview of connection to devices on your network:

4. Using Out of Band Management

The remote.itPi includes an out of band management feature, that allows remote access through a secondary Internet connection. This is typically useful if the remote network that you are managing is isolated from the Internet (no internet connection) or if perhaps the Internet connection has gone down, and you need a way to get to the network to reset the router.

The following figure, details how the data flows when out of band management is active on the remote.itPi.

Note: To use out of band management, the remote.itPi must be connected to the private network (the network that you would like to manage through the out of band connection) using the Ethernet jack on the Raspberry Pi.

Out of Band Management is automatically activated if the remote.itPi detects that it has a active network connection on the Ethernet port and it also detects an active wi-fi connection, where the out of band wi-fi network that the remote.itPi is preconfigured to look for is:

SSID: remote.itPi Password: remote.itPi

If both those conditions are met, out of band mode is automatically detected and the on-screen indicator turns on.

The OUT OF BAND Indicator on the top right is active.

5. Connecting Remotely from Anywhere

Remotely connecting to registered devices and services can be done from:

Connecting via the Web Portal

When you login to the remote.it web portal, you will see a device list, where your newly registered remote.itPi will appear.

If you mouse click onto the connect button, you will see a dropdown of the possible remote connections for that device. If the supported application is a web-browser, then selecting that connection will automatically open a new browser tab with a direct connection to that service.

If you are making a connection to an application where you use client software that expects a URL or a URL:port combination, you will be presented with the following dialog, where the values can be used directly.

In this example, since the target application is Windows Remote Desktop, entering the values as such will launch the connection to the remote computer.

Connecting using the remote.it Desktop Application

Connecting using the Desktop App is simple, and a guide to do so can be found here:

Here is an image of a sample connection made by the Desktop App