Getting started - create your account and claim your first hub

How to create a RoamVitals account, sign in, find your hub's claim code, and link your first hub to your account.

In the app: /hubs

Three things stand between you and live data from your RV: an account, a sign-in, and linking your hub to that account. Allow about five minutes, plus a few more for the first readings to arrive.

One thing that surprises people: the sign-in and sign-up screens are headed RV Monitor, and once you are signed in the app is branded RoamVitals. The browser tab reads RV Monitor throughout. It is the same product.

Before you start#

• Your hub, powered on and connected to the internet at least once.
• A phone, tablet or laptop with a web browser.
• The web app at app.roamvitals.com.

1. Create your account#

1. Open the app. If you are not signed in, you land on the page headed RV Monitor with Sign in to your account underneath.
2. At the bottom, next to Don't have an account?, select Register.
3. Fill in Email, Password and Confirm Password.
4. Select Register.

As you type a password, a coloured bar appears under the field with one word beneath it: Weak, Fair, Good or Strong. It is a guide, not a gate. Longer passwords with a capital, a digit and a symbol score higher.

Example. Enter [email protected], then RiverBend#2026 in both password fields. The strength bar fills green and reads Strong. Select Register.

There is no confirmation email and no code to enter. You are signed in straight away and land on the Dashboard.

What to do if:

• The two passwords differ. The Confirm Password field turns red with the helper text "Passwords do not match", and selecting Register shows the same message in a red bar at the top. Retype one of them.
• A red bar reads "User already exists". That address already has an account. Go back and sign in, or reset the password.
• You are not sure how you capitalised your address. It does not matter. [email protected] and [email protected] are the same account.

2. Sign in#

1. Go to the sign-in page.
2. Enter Email and Password.
3. Select Sign In.

A wrong address or password gives a red bar reading "Invalid credentials". The app does not tell you which of the two was wrong, on purpose.

Keep trying and you will be paused for a moment. About ten sign-in or sign-up attempts in a minute from the same internet connection get you a red bar reading "Too many requests. Please wait before trying again." Wait a minute and carry on.

Sessions do not last forever. When yours expires, the app returns you to the sign-in page and you simply sign in again.

3. If you forget your password#

1. On the sign-in page, select Forgot your password?
2. You land on the page headed Reset Password, which reads "Enter your email and we will issue a one-time reset token."
3. Enter your Email and select Request Reset. A green bar confirms: "If the address is registered, you can continue with the reset flow below." You get the same message whether or not the address has an account, so nobody can use this page to discover who has one.
4. Once you have your reset token, select Continue to Reset Password. That takes you to the page headed Set New Password.
5. Paste the token into Reset Token, fill in New Password and Confirm New Password, then select Reset Password.
6. A green bar confirms: "Password updated successfully. You can sign in with the new password now." Select Back to Sign In.

Things worth knowing about the token:

• It works once, and it expires one hour after it was issued.
• The app never displays it. If you do not have a token in hand, contact support rather than requesting more.
• A token that is mistyped, expired or already spent gives a red bar reading "Invalid, expired, or already-used reset token". Request a fresh one and try again.

If you can still sign in and just want a new password, this whole flow is unnecessary: go to Settings and use Change Password instead.

4. Find your hub's claim code#

Your hub introduces itself to RoamVitals the first time it starts up with a working internet connection, and RoamVitals gives it a short claim code. The hub shows that code on its own screen until somebody claims it. Until then the hub keeps its readings to itself, so nobody can see your data before you claim it.

1. Connect your phone or laptop to the same network as the hub.
2. Open http://roamvitals.local in a browser. That is the hub's own screen, served by the hub itself.
3. Go to Settings and find the Cloud Connection panel.
4. Read the status line in that panel, below the short explanation.

Example. The line reads:

Registered (hub ID 8f21c7d4-6b0e-4a51-9a77-2d5b1c9e4f30). To see this hub's data in your account, sign in at the portal and enter claim code: K7RM-4TQ9

The code you want is K7RM-4TQ9.

A claim code is two groups of four characters separated by a hyphen. The characters never include the letters O or I, or the digits 0 or 1, so there is nothing ambiguous to squint at.

What to do if:

• The line reads "Not registered yet. Enter your cloud details below, then select Register Hub." The hub has not reached RoamVitals yet. Get it onto a working internet connection, then select Register Hub in that same panel. Despite the wording there is nothing for you to type: Hub serial number fills itself in and cannot be edited, and the address of the service is fixed. A line under the button then reads "Registered. Hub ID ... Your buffered readings will now upload.", and the status line above changes to show your claim code. Restarting the hub does the same job, but a hub that is already running will not register itself on its own.
• The line reads "Registered with the cloud (hub ID ...). Readings upload automatically." with no code. This hub is already linked to an account. If it is not in your list, contact support before buying a second one.
• The hub screen asks you to unlock it. The screen is headed Authentication Required and reads "Protected mode is on. Enter your local API key below to unlock the hub, then use Settings for day-to-day access and config management." Your hub was set up with a key. Type it into Local API key and select Unlock before the Settings screens, including Cloud Connection, will open. Most hubs ship without a key and go straight to the dashboard.
• roamvitals.local does not open. Some networks, especially public campground Wi-Fi and some guest networks, block the way that name is looked up. Try from a different device on the same network. Failing that, the hub keeps its own Wi-Fi network up the whole time it is running, named after the hub (for example RoamVitals-Otter) with the password printed on the card that came with it. Join that network and open http://roamvitals.local again.

5. Claim the hub in the app#

1. Sign in at app.roamvitals.com.
2. Select Hubs in the navigation. (On the dashboard's built-in layout you can also use Manage in the Your Hubs panel, or Add Your First Hub, which is only there while you have no hubs. Both take you to the same page.)
3. Select Claim a Hub. It is the filled button at the top right of the Hubs heading, and it also appears in the middle of the page under No hubs registered when you have no hubs yet.
4. The dialog Claim a Hub explains: "Power on your hub and open its local screen - it shows a short claim code. Enter it here to link the hub to your account."
5. Type the code into Claim code. Letters are capitalised for you as you type, but type the hyphen yourself, exactly as the hub shows it.
6. Select Claim Hub, or press Enter.

Worked example. The hub screen shows K7RM-4TQ9. You type K7RM-4TQ9 into Claim code and select Claim Hub. The dialog answers:

✓ "RoamVitals-Otter" is now linked to your account. Its sensors and readings will appear shortly.

Select Done.

The name in that message is the name the hub reported for itself, the same one printed on its box. If it did not report one, you will see a name built from its serial number instead, like Hub 4F21C7. You can change it either way: on the hub's card, double-click the name, or select the pencil icon to open Edit Hub, where you can set Hub Name and Location (optional).

What you will see next#

• The hub appears as a card on the Hubs page showing a status badge (for example Online or Offline), SN: with its serial number, Firmware: with its version, and a Last seen: time.
• The badge normally reads Online as soon as you claim it. A hub that is showing a claim code has been checking in with RoamVitals all along, roughly every five minutes, so its Last seen time is already there. Offline means nothing has been heard from the hub for about ten minutes, which points at power or internet rather than at the claim.
• The Hubs page does not refresh itself. Reload it to see the status, the Last seen time and the sensor count move on.
• The hub re-checks whether it has been claimed every few minutes, so readings usually start flowing within about five minutes rather than instantly. A hub whose network you have ticked as a phone hotspot or data-capped, under Network & Data on the hub's own Settings, checks in less often, so give it longer.
• Readings the hub took before you claimed it were kept on the hub, not thrown away. They upload once the link is made, so your history does not start from zero.
• Sensors the hub is tracking appear under the hub on their own as their readings arrive, up to the number of sensors your plan includes. You do not have to add them one by one. There is an Add Sensor button on the hub's own page, but that is for typing in a device by hand with its MAC address, and a sensor the hub has already found does not need it.

What to do if#

• The dialog says the code was not found. The message is "That code wasn't found. Check it's typed correctly - it may already be claimed." Retype the code, hyphen included, straight off the hub screen. Each code works once and disappears the moment a hub is claimed, so this also appears if the hub is already on somebody's account.
• Nothing arrives after ten minutes or so. Reload the Hubs page first, since it does not update on its own. If it is still bare, open the hub screen again and re-read Settings then Cloud Connection. Once claiming has taken effect there, the line reads "Registered with the cloud (hub ID ...). Readings upload automatically." If it still shows a claim code, the hub has not been online since you claimed it.
• You were looking for the other button. The outlined Add Hub button next to Claim a Hub (it reads Add Manually on the empty page) is a different thing. It opens Add New Hub, which creates a hub entry from a Hub Name and a Serial Number ("Found on the label of your hub device"), with Location (optional) if you want it, and it is limited by how many hubs your plan allows. It is not the way to connect a hub that is showing a claim code: if that serial number is already known to RoamVitals, which it will be as soon as the hub has been online once, the dialog reports an error instead of linking it. Use Claim a Hub.

If somebody shares a hub with you#

You do not need a hub of your own to use the app. When another owner invites you, a Pending invitations card appears near the top of the Hubs page reading "A hub has been shared with you" and "Accept to view its data (read-only)".

1. Select Accept.
2. A dialog opens, headed with the hub's name followed by "has alerts set up". If there are alerts you are not already receiving, you can select Subscribe to all, or Choose, which turns the list into tick boxes and the button into Subscribe to selected, or Skip for now. If there is nothing to decide, it says "Nothing here needs a decision from you right now." and Skip for now is the only button.

Safety alerts are not part of that choice. Accepting a share switches them on for you, and the dialog lists them at the top as already on, with a note that you can turn them off later under What reaches me on the Alerts page.

Shared hubs carry a Shared · read-only badge. You can see their data, but the rename, share and delete controls are not shown for them.

Signing out#

Select the account icon at the top right. The menu shows the email address you are signed in as, Settings, and Logout.