Skip to Content
Onshore is in early access. Don’t load real customer data until the items in Known limits are closed.
Get startedSigning in

Signing in

The console always asks for two things: something you know (your password, or your organisation’s single sign-on) and something you have (an authenticator app code, or a passkey). A password alone never opens the console.

With a password

Enter your email and password

The sign-in page with email and password fields, Continue, Continue with single sign-on, and Forgot your password

Select Continue.

Enter the 6-digit code from your authenticator app

The code step, asking for the 6-digit code

Use any authenticator app: Google Authenticator, Microsoft Authenticator, 1Password, Authy and others. Select Verify and sign in.

The first time

The first time you sign in, Onshore shows a QR code instead of asking for a code. Scan it with your authenticator app (or type the key shown under it), then enter the code the app shows. Two-factor authentication is required for everyone.

Right after that, you get ten recovery codes. Each one gets you in once if you lose your phone. They’re shown only then: download or copy them, and keep them somewhere safe, away from your phone.

If an admin created your account with a temporary password, you’ll choose your own password after entering your first code.

With a passkey

A passkey (or a security key such as a YubiKey) can stand in for the 6-digit code. It can’t be phished: your device signs only for this site. Add one in Settings → Sign-in; see Two-factor and passkeys.

At the code step, select Use a passkey and confirm on your device:

The code step with the Use a passkey button highlighted

With single sign-on

If your organisation uses Microsoft Entra ID, Okta, Google or another identity provider, type your work email and select Continue with single sign-on. You’re sent to your provider to sign in, and come back signed in.

The sign-in page with Continue with single sign-on highlighted

Your provider handles two-factor authentication. If single sign-on fails, the page says so: usually your admin hasn’t added you, or none of your groups gives you a role. See Single sign-on.

Staying signed in

You’re signed out after 15 minutes without activity (your installer can set 5 to 720 minutes with RV_SESSION_IDLE_MINUTES), and always after 12 hours, even when active. Changing your password signs you out everywhere.

Locked out?

What happenedWhat to do
Forgot your passwordSelect Forgot your password? on the sign-in page. A link arrives by email (if your organisation has set up email). You’ll still need your code
Forgot your password, and no email is set upAsk an admin to use Reset password on your page under People. They pass the link to you
Lost your phoneSelect Use a recovery code instead at the code step. Then set up a new authenticator in Settings → Sign-in
Lost your phone and your recovery codesAsk an admin to use Reset two-factor on your page under People
Every admin is locked outSomeone with access to the server runs ./rv admin-recover -email you@company.example -reason "…", which prints a one-time link
The forgot password page

Links work once, are stored only as hashes, and expire: invitations after 7 days, password resets and recovery links after an hour. Admin resets need another admin; nobody can reset themselves. Everything is in the audit log.

Using a recovery code emails you a notice, and the console tells you how many codes you have left.

Last updated on