Menu

Client Setup

Here you can setup your various devices and browsers to be able to access your Vaultwarden server.

Browser Extension

If connecting via Tor (i.e using the .onion address) the Bitwarden browser extension will only work with a Tor enabled browser.

  1. If you choose Firefox, you will need to follow this guide to run Tor on your device and configure Firefox to use it. If using Brave you will just need to setup Tor on your device. With Tor Browser, everything will just work right out of the box.

    Tip

    We recommend using Firefox as it is the most compatible browser with Start9 Servers.

  2. In this example we will use Firefox, though these instructions will work just the same for Brave. First, install the Bitwarden browser extension.

  3. Head to the “Interfaces” tab in the Vaultwarden service on your Start9 Server:

    vaultwarden-interfaces
  4. Copy the Tor address:

    vaultwarden-tor-address
  5. Now head to the Bitwarden extension and click the “Region” dropdown menu and choose self-hosted. Under Self-hosted environment you will see a field for Server URL.

    vaultwarden-firefox-self-host
  6. Now you need to grab the address of your Vaultwarden server. Paste the address into your extension and click “Save”.

    vaultwarden-firefox-url
  7. Now enter your credentials and the Bitwarden extension will be logged into your self-hosted Vaultwarden server!

Android

You will need to Setup Tor on your device first.

  1. Visit your app store of choice and download the Bitwarden app. Once downloaded and installed, let’s go into Orbot, and add the app to the VPN apps list. You may need to hit the refresh button in the top left to get it to populate.

  2. Next, enter the Bitwarden app. You’ll be greeted with a log-in screen. Go to the top left gear icon to enter the settings.

  3. Head to the “Interfaces” tab in the Vaultwarden service on your Start9 Server:

    vaultwarden-interfaces
  4. Copy the Tor address:

    vaultwarden-tor-address
  5. Now send that address to your phone and paste it into Bitwarden.

  6. Hit save.

  7. Go ahead and tap ‘Log In,’ enter your credentials, and you can access your Bitwarden app / Vaultwarden server.

iOS

Warning

Orbot is currently broken for iOS, which means it is not possible to use Bitwarden over Tor. We are hopeful that a future release of Orbot or iOS will resolve the issue.

Desktop Clients

First, be sure to get Tor running on your system.

  1. Install Bitwarden either by using a package manager like apt (we recommend against using snap) or download it from here.

  2. Run the program with the flag --proxy-server=socks5://127.0.0.1:9050 behind it. You can run this from a terminal, and if you’d like to use a shortcut, edit that shortcut file to include the flag.

  3. As with the other solutions above, click the ‘Settings’ icon, and enter your Vaultwarden Tor address. You can then log in to your vault.

Alternatively, you may be able to run using your LAN address, but this has proven finicky, especially on Debian/Ubuntu systems. You will have better luck if you have the Root CA installed at the OS level. First, be sure to Setup LAN natively.

  1. Begin by making sure that Tor is running on your Mac.

  2. Download the Bitwarden Desktop app.

  3. Open the Bitwarden app and click on the “Region” drop-down menu:

    bitwarden-mac
  4. Head to the “Interfaces” tab in the Vaultwarden service on your Start9 Server:

    vaultwarden-interfaces
  5. Copy the Tor address:

    vaultwarden-tor-address
  6. Paste the address into Bitwarden and click the save button:

    bitwarden-tor-mac-url
  7. Enter the email used to create the account, followed by the password, then click “Log in with master password”.

  1. Download the Bitwarden Desktop app.

  2. Follow the Tor setup in the instructions below. Make sure the Bitwarden directory is located in your user’s directory, C:\Users\YOURUSER\AppData\Local\Bitwarden. This is because you need permission to run over a proxy. You can make a shortcut wherever you’d like.

  3. Right-click the shortcut and click ‘Properties.’ Add the flag --proxy-server=socks5://127.0.0.1:9050 to the end of the ‘Target’ field. Click ‘Apply,’ then ‘OK.’ Close Properties and launch the shortcut.

  4. As with the other solutions above, click the ‘Settings’ icon, and enter your Vaultwarden Tor address. You can then log in to your vault.