Linking an Orb to Your Account

This guide explains how to link Orb sensors to your account, allowing you to monitor multiple devices or locations from all Orb app instances.

What is an Orb Sensor?

An Orb sensor is any device running the Orb software that monitors network connectivity. This can be:

  • Your smartphone or tablet with the Orb app installed
  • Your computer running the Orb desktop application
  • A dedicated device like a Raspberry Pi running the Orb agent
  • A router with Orb monitoring capabilities

Benefits of Linking Multiple Sensors

Linking multiple sensors to your account provides several advantages:

  • Monitor different networks (home, office, vacation property)
  • Compare wired vs. wireless performance
  • Track network health in different parts of your home
  • Have a dedicated 24/7 monitoring device while still using the mobile app

Linking Methods

There are several ways to link an Orb sensor to your account:

Method 1: Automatic Discovery (Recommended)

If your new Orb sensor is on the same local network as a device already signed in to your Orb account:

  1. Install the Orb app on the new device
  2. Open the app and wait for the automatic discovery process
  3. On your already-linked device, you'll receive a notification about the new sensor
  4. Tap "Link to my account" to connect the sensor
Auto Link

Method 2: Sign In Directly

You can also simply sign in to your Orb account in teh Orb app on the new device:

  1. Install the Orb app on the new device
  2. Open the app and tap "Sign In"
  3. Enter your Orb account email and password
  4. The device will automatically be added as a sensor to your account

Manually linking a Sensor

If you need to manually link a sensor to your account:

  1. In the Orb Summary, find the Orb sensor you would like to link (see "Orbs on this network")
  2. Tap on the Orb setting menu (... near the sensor name)
  3. Tap "Link this Orb to your account" Note: this method will only work for headless devices (e.g. raspberry pi). To manually link a device running the Orb app, sign into your account from this device and follow the steps above.
Account Link

Linking a Sensor with CLI

To link a sensor to your account via the command line:

  1. Open a terminal on the device
  2. Run the command orb link
  3. The output of that command will include a short URL to link to your account
  4. Copy that URL into a browser on any machine, and login to your account at the prompt
  5. That Orb will now show up in any app where you’re logged in

Naming Your Orb Sensors

After linking a sensor, it's helpful to give it a descriptive name:

  1. In the Orb app, go to the Orb settings menu (...)
  2. Tap "Rename" and enter a descriptive name (e.g., "Living Room Pi", "Office Desktop", "iPhone")
  3. Tap "Save"
Rename Orb 1 Rename Orb 2

Unlinking a Sensor

If you need to remove a sensor from your account:

  1. In the Orb Summary, find the Orb sensor you would like to unlink
  2. Tap on the Orb settings menu (...)
  3. Tap "Remove from your account"
Remove Orb

Note that unlinking a sensor will not delete historical data already collected from that sensor.

Troubleshooting

Sensor Not Discovered Automatically

If automatic discovery fails:

  • Ensure both devices are on the same local network
  • Check that your network allows device discovery (some corporate or public networks restrict this)
  • Try the manual linking method instead

Next Steps

Now that you've linked your sensors, learn more about:

Edit this doc on GitHub