Before you start

RaptorPass works with the Bitwarden app, which is free and published by Bitwarden, Inc. Your account must already exist: first open the invitation you received by email and create your master password.

Your vault's address

It is in your welcome and access confirmed emails, and looks like this:

https://acme-k7f3q2m8xp.fr.raptorpass.eu

Don't use the app's account creation button: it would create an account with Bitwarden, unrelated to your vault.

Install the app

Download the app:

  1. Tap "Install" in Google Play.
  2. Open Bitwarden from the home screen.

Link the app to your vault

This is the step that matters: without it, the app looks for your account at Bitwarden and doesn't find it. You only do it once per device.

  1. Below the "Email address" field, tap "Logging in on: bitwarden.com".

  2. In the list, tap "Self-hosted".

  3. The "Settings" screen opens. In the "Server URL" field, paste your vault's address, then tap "Save" at the top right.

  4. Below the email field, the app now shows "Self-hosted". Enter your email address, then tap "Continue".

  5. Enter your master password.

Simplified illustration: the actual screen may differ slightly.

Fill in your passwords everywhere

  1. In Bitwarden, tap "Settings", then the autofill section.
  2. Turn on "Autofill services", then choose Bitwarden on the system screen that opens.
  3. On a sign-in page or in an app, tap the username field, then choose your account.

Unlock without retyping your password

In Bitwarden, tap "Settings", then "Account security", and turn on "Unlock with Biometrics". You will still need your master password from time to time, so keep it safe.

Troubleshooting

  • "Invalid credentials" or account not found: first check that the sign-in screen shows "Self-hosted", not bitwarden.com. If not, go back to the "Link the app to your vault" step.
  • You can't see shared passwords: your administrator must confirm your access. You receive an email once that's done, and the items appear after a sync.
  • You don't know your vault's address: it is in your welcome and access confirmed emails. Your administrator can also give it to you.
  • Forgotten master password: nobody knows it and it cannot be recovered. Contact your administrator.