Hubs, hub status and sharing

How to read the Hubs page, what Online and Offline mean, and how to rename a hub or share it read-only with another person.

In the app: /hubs

Your hubs live under Hubs in the left navigation, or in the bottom bar if you are on a phone. The bar across the top of the app reads Hubs, with the line "Your hubs, members and activity" under it. That top bar keeps saying the same thing when you open an individual hub.

What the Hubs page shows#

At the top right there are two buttons: Add Hub and Claim a Hub. If you have no hubs yet, the page shows "No hubs registered" with the line "Power on your hub and enter the claim code it shows to link it to your account", plus Claim a Hub and Add Manually.

Once you have at least one hub, a row of filter buttons appears with live counts: All, Online, Offline and Error. Selecting one narrows the cards below. If nothing matches you will see "No hubs match the selected filter."

Each hub is a card showing:

• The hub name and a status pill reading Online, Offline, Error or Updating
• A Shared · read-only chip, only on hubs that someone else shared with you
• SN: followed by the serial number
• Firmware: followed by the version the hub last reported
• 📍 followed by the location you set, if you set one
• Last seen: followed by the date and time the hub last checked in. A hub that has never reached the cloud has no Last seen line at all
• The number of sensors on the hub

Click anywhere on a card to open that hub's own page.

The small icons in the top right of each card are Edit hub, Share hub, Delete hub and View hub activity. On a hub that was shared with you, only View hub activity appears.

View hub activity opens a panel titled "Hub Activity - <hub name>" listing the newest readings and alert events for that hub. Each row is a small chip reading reading or alert_event, then the sensor's name, with the date and time underneath. The reading values and the alert text are not shown here, so go to the sensor's own page or to Alerts for the numbers and the wording. If there is nothing yet it says "No recent activity for this hub."

What Online and Offline mean#

Your hub checks in with the cloud every few minutes over whatever internet connection it has, five minutes apart by default. Each check-in updates Last seen.

• Online means the hub has checked in recently.
• Offline means nothing has been heard from the hub for about ten minutes, so one missed check-in is not enough to flip it. It does not mean the hub is broken - most of the time it means the RV lost internet or the hub lost power.
• Updating can show after your hub applies a software update. The next check-in puts it back to Online. There is no Updating filter button, so while a hub is in that state it appears only under All. The ten-minute rule only moves hubs that are currently Online, so a hub that stops checking in while it still says Updating stays on Updating instead of falling back to Offline.
• Error is not a state your hub reports, so that filter normally shows 0.

Offline is about the connection to the cloud, not about the hub's own work. A hub that is running but cut off keeps taking readings and stores them locally, then uploads what it collected once it is back online. Your history fills back in after it reconnects.

Nothing on these pages refreshes itself. The status on screen is the status as of the moment the page loaded. Reload the page to check it again.

What to do if a hub shows Offline#

1. Look at Last seen on the card. That is the moment the connection stopped. If the card has no Last seen line, this hub has never reached the cloud at all, so the problem is the first link-up rather than a dropout.
2. Check that the hub has power and that the RV's internet connection (Wi-Fi, hotspot or cellular router) is up.
3. Wait a few minutes after the connection comes back, then reload the page. The hub only checks in periodically, so the card can stay Offline for a short time after the RV is back online.
4. If it stays Offline for hours with power and internet confirmed, contact support with the hub's serial number from the card.

The hub's own page#

Opening a hub shows a back arrow, the hub name, an edit icon (tooltip "Edit hub name / location"), and the Add Sensor and Sensor Maps buttons.

Below that is a summary row: Status, Serial, Firmware, Location and Last Seen. Status here is the plain lower-case word (online, offline) rather than the coloured pill from the card, and Location and Last Seen show - when there is nothing to show.

Device Health appears only while the hub is Online. It shows bars for CPU, Memory and Disk, then a row of figures for Uptime and Active Sensors. A Temperature bar joins the other bars only when the hub reports a figure above zero, and a Wi-Fi RSSI figure joins the row only when the hub reports a signal strength. If no health report has arrived yet the panel says "No metrics available yet".

When the hub reports on its own background jobs, a System Health line appears underneath with either All systems healthy or Needs attention. When it says Needs attention, the lines below name the jobs that stopped or restarted, using plain names such as Sensor scanning, Cloud sync and Software updates, each followed by either "- stopped" or "- recovered after 2 restarts".

Further down are three more boxes:

• Tags - short labels you can put on a hub. It reads "No tags yet" until you add one. Type into the New tag… box and click Add, or press Enter. Tags are saved in lower case, are capped at 40 characters, and a repeat of one you already have is ignored. Each saved tag is a chip with a small x on it that removes it.
• Hub Config - shows Sync Interval and BLE Scan Interval in seconds, plus Notes when a note has been saved. Click Edit to change them: the fields become Sync Interval (s), BLE Scan Interval (s) and Notes, with Cancel and Save. Sync Interval will not save below 10 seconds, and BLE Scan Interval will not save below 5.
• Sensors (n) - with a Search sensors… box and status chips All, connected, disconnected, error and unknown. Before any sensors exist it reads "No sensors added yet"; when the search or chip matches nothing it reads "No sensors match your filter".

If you open a hub that is no longer on your account you will see "Hub not found." with a Back to Hubs button. That happens while you still have at least one other hub. If the hub you removed was your only one, you get a mostly empty page headed Hub Detail instead.

Renaming a hub#

There are two ways. The quick way, from the Hubs page:

1. Double-click the hub's name on its card. Hovering the name shows the hint "Double-click to rename". The name turns into a text box.
2. Type the new name.
3. Press Enter to save, or Escape to cancel. You can also click the pencil that appears beside the box, whose tooltip is "Confirm rename (Enter)".

A hub cannot be left nameless: clearing the box and pressing Enter simply closes the editor and changes nothing. While the box is open, clicking elsewhere on the card does nothing either, so finish with Enter or Escape.

The full way, which also sets the location:

1. Click the pencil icon on the card (Edit hub), or the pencil icon at the top of the hub's own page.
2. In the Edit Hub dialog, change Hub Name.
3. Optionally fill in Location (optional) - the placeholder suggests "e.g. Garage, RV Bay 1".
4. Click Save.

Example#

A hub that has not been named yet is called Hub followed by the last six characters of its serial number. So a hub showing SN: RVDEV2-31C55F9F arrives named Hub C55F9F. Some hubs are stamped with a friendly name when they are built and arrive under that name instead. To make it recognisable:

1. Click the pencil on that card.
2. Set Hub Name to Big Bertha.
3. Set Location (optional) to Front bay.
4. Click Save.

The card now reads Big Bertha, with 📍 Front bay under the firmware line. The name is yours from then on - once you have set a name, the hub checking in does not overwrite it.

Renaming is cosmetic. It does not change the serial number, the sensors, or any alerts.

Sharing a hub with another person#

Sharing gives someone read-only access. They can look, they cannot change anything.

1. On the Hubs page, click the share icon (Share hub) on the hub's card. The dialog is titled Share "<hub name>".
2. Type the person's address in Email to invite.
3. Choose All devices or Specific devices. With Specific devices, tick the sensors they should see.
4. Click Invite. The button sits beside the email box, above the device choice, but it is still the last thing you press.

They then appear under People with access with a status of pending until they accept, then active. Next to each person you will see either All devices or the number of devices they can see. Until you invite anyone the list reads "No one else has access yet." Close the dialog with Done.

Example#

You want your partner to watch the fridge and the water tank while you are away, at [email protected]:

1. Click the share icon on Big Bertha.
2. Enter [email protected] in Email to invite.
3. Select Specific devices and tick Fridge Temp and Fresh Water Tank.
4. Click Invite.

People with access now lists [email protected], a pending chip and "2 device(s)".

Three things to know before you invite#

Tick at least one device. If you choose Specific devices but leave every box unticked, the share is saved as All devices - and that is what the row under People with access will say. Check the row after you invite to confirm it matches what you meant.

Sensors with safety alerts carry a shield. In the Specific devices list those sensors have a small red shield beside the name. A warning appears in the dialog whenever your selection leaves one of them out, which includes the moment you pick Specific devices, before you have ticked anything. It names the devices and explains that safety alerts (CO, propane, smoke) reach everyone who can see the device, on any plan, so leaving them out means this person will not be told. Read that warning before saving a narrow share.

There is no invitation email. The invitation appears inside the app, on the invited person's own Hubs page. Tell them to sign in and look there. They need a RoamVitals account using that email address - capitalisation does not matter. If they do not have an account, ask them to sign up with that address, and the invitation will be waiting.

Accepting an invitation#

When a hub has been shared with you, a Pending invitations card appears near the top of your Hubs page reading "A hub has been shared with you" / "Accept to view its data (read-only)". The row does not name the hub, so if you have more than one invitation waiting they look identical.

1. Click Accept.
2. A dialog appears titled "<hub name> has alerts set up", listing the alerts on that RV.
3. Click Subscribe to all, or Choose to tick individual alerts and then Subscribe to selected, or Skip for now.

If there is nothing for you to decide, the dialog says "Nothing here needs a decision from you right now." and Skip for now is the only button.

The alerts you subscribe to use your own daily allowance, not the owner's, which is why nothing is switched on for you without asking. The exception is safety alerts: those are already on when you accept, because a CO alarm that reaches only the owner is not much of an alarm. You can turn them off later on the Alerts page under the What reaches me tab.

The hub then appears in your Hubs list with the Shared · read-only chip.

What a shared read-only member can and cannot do#

Can:

• See the hub in their Hubs list, with its status, serial number, firmware, location and Last seen
• Open the hub and see the sensors they were given, with their readings and history
• Open View hub activity for the hub
• Receive its safety alerts, and any other alerts they subscribed to when accepting

Cannot:

• Rename the hub or change its location
• Delete the hub
• Share it with anyone else, or see who else has access
• Add, change or remove sensors
• See sensors that were left out of their share

One oddity: the sensor count on the card is the hub's total, so on a device-scoped share it can be a bigger number than the list of sensors you can actually open.

On the Hubs page those controls are simply not drawn on a shared hub's card - only the activity icon is there. On the hub's own page some owner controls are still displayed, including the edit pencil, Add Sensor, Sensor Maps, Tags and Hub Config. They will not work for a shared member: saving returns an error, the Tags box keeps saying "No tags yet", Hub Config stays on "Loading…", and Device Health shows "No metrics available yet". Nothing is changed for the owner if you press them.

Changing or removing someone's access#

Open the share dialog again from the hub's card.

• Access next to a person opens "Device access - <their email>", where you can switch them between All devices and Specific devices and change the ticks. Click Save. The same trap applies here: switching to Specific devices and leaving every box unticked saves as All devices, not as "no devices".
• Revoke removes their access immediately. There is no confirmation step, so click carefully. The hub disappears from their list and they stop receiving its alerts.

Deleting a hub#

The trash icon on a hub's card opens a Delete Hub dialog asking: "Are you sure you want to delete this hub and all associated sensors and readings? This action cannot be undone." Click Delete to go ahead or Cancel to back out. Only the owner sees this icon.

Everything attached to the hub goes with it: its sensors and all their readings, the alerts built on those sensors and their history, its sensor maps, and any access you had granted to other people. There is no single button that exports a whole hub, so save what you want to keep first. Each sensor's own page has an Export button that downloads that sensor's readings as a CSV, and the Reports page can pull history across several sensors at once.