Menu

Caution

You are not reading the latest stable version of this documentation. If you want up-to-date information, please have a look at 0.3.5.x.

Vaultwarden Initial Setup

Web Vault

  1. Ensure Vaultwarden is running - click START on your Start9 Server if not:

    vaultwarden-start-service
  2. Once the health check turns green, click Launch UI:

    vaultwarden-launch-ui
  3. Time to create an account! Click Create account:

    vaultwarden-create-account

    Note

    You are creating an account with yourself on your own Vaultwarden website served from your own Vaultwarden server - there are no third parties involved here.

  4. Enter an email address for login:

    vaultwarden-create-account-email

    Tip

    This email address can be anything you like. It doesn’t have to be real. It is simply a way for you to log into Vaultwarden from Bitwarden apps on your devices. Your Vaultwarden server won’t ever email you.

    Tip

    You cannot use this email address to reset your master password - it is simply used to create an account on your server.

    Warning

    Do not lose it - you will not be able to log in without it!

  5. Enter a name for the account, a strong password and (optionally) a password hint - then click Create account:

    vaultwarden-account-creation

    Warning

    It is important to realize that this is the ‘Master password’ for all your other passwords. Make it very strong, memorize it, write it down, and back it up to a safe place. If you lose it, you may lose access to all your passwords and your entire digital life.

  6. Now you can log in to your new password manager! Enter your email to login:

    vaultwarden-login-email
  7. Then your master password:

    vaultwarden-login-password
  8. We are greeted with our newly setup Vaultwarden password vault!

    vaultwarden-fresh-vault
  9. At the top you can visit Tools for reports and to use the password generator. You can also import data from another program, such as Lastpass, Onepass, or KeePass!

    vaultwarden-tools
  10. Account settings gives you all your options, including the ability to set up 2 factor authorization.

    vaultwarden-account-settings
  11. Now you’re ready to start storing some passwords!

Storing your first password

  1. Back at the main page for your vault, let’s do a quick example login. We’ll start by creating a folder for it:

    vaultwarden-click-add-folder
  2. Name the folder and click Save:

    vaultwarden-add-folder
  3. Click Add item:

    vaultwarden-add-item
  4. Now add the credentials and click Save:

    vaultwarden-add-new-login

    Tip

    An entry can have multiple URLs - for example you may wish to enter both an onion address and a .local address for one of the services you have running on your server. We are increasing the numbers of ways in which you can connect to your services, soon they may even have simple .com addresses!

  5. And there we have it - our first set of login credentials.

    vaultwarden-new-login

Congratulations! You have setup your own self-hosted password manager and have added a set of login credentials to it!

Accessing the Admin Console

  1. You will find the Admin console by heading to “Interfaces” on the Vaultwarden Service page.

    vaultwarden-interfaces
  2. Copy either of the addresses here and append /admin:

  3. You will be prompted for your “Admin Token,” which can be found on your Vaultwarden Service page under “Properties.”

    vaultwarden-admin-properties
  4. Copy the token here:

    vaultwarden-admin-properties-admin
  5. And paste it here:

    vaultwarden-admin-console-auth
  6. You’re now logged in to the admin panel.

    vaultwarden-admin-console

    Note

    This cannot be used to reset passwords for accounts created on your Vaultwarden server.

Now you’ll want to setup some client devices! Head here for instructions on how to do so.