Skip to content

Commit

Permalink
Update instructions.md
Browse files Browse the repository at this point in the history
  • Loading branch information
MattDHill authored Jan 11, 2023
1 parent 0514987 commit 30656fc
Showing 1 changed file with 2 additions and 70 deletions.
72 changes: 2 additions & 70 deletions docs/instructions.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,77 +6,9 @@ Vaultwarden is a _self-hosted_ password manager, which means your passwords phys

## Connecting to Your Vaultwarden Server

### Using Bitwarden Browser Extension (detailed screen shots below)
You can use Vaultwarden simply by visitng your unique .local or .onion address in the browser. You can also use a variety of Bitwarden clients, including browsers extensions, desktop apps, and mobile apps. For a complete list of options and detailed instructions, see the [docs](https://docs.start9.com/latest/user-manual/service-guides/vaultwarden).

- The Bitwarden browser extension will work on Firefox (recommended) or Tor Browser. It will _not_ work on Chrome, Internet Explorer, or Brave. For Firefox, you must first ([get Tor running on your machine](https://docs.start9.com/latest/user-manual/connecting/connecting-tor/tor-os/index#tor-os)) and then enable Tor by following ([these instructions](https://start9.com/latest/user-manual/connecting/connecting-tor/tor-firefox/index)).

### Using Bitwarden Mobile App

- To use the Bitwarden mobile app, see the [Android instructions](https://start9.com/latest/user-manual/connecting/connecting-tor/tor-os/tor-android). Unfortunately the iOS Bitwarden mobile app is not compatible with Embassy yet.

- It is also possible to connect using your LAN (.local) address, and your data will be cached for use on the go. Please note that this method will not allow updating or syncing with your server when not on your local network.

> **_NOTE:_** Some mobile device users see an error with the text *"We were unable to process your request. Please try again or contact us." or similar* when using the `.local` address, this can be bypassed by continuing as if there were no error. If this does not work, more troubleshooting may be required.
### Using Bitwarden Web Vault

- Simply click "Launch UI" from your Embassy Vaultwarden page.

## Detailed Instructions for using the browser extension

1. Open the browser and visit the add-ons section.

<!-- MD_PACKER_INLINE BEGIN -->

![](./assets/img-1.png)

<!-- MD_PACKER_INLINE END -->

2. Search for “Bitwarden” and click “Add to Firefox”.

<!-- MD_PACKER_INLINE BEGIN -->

![](./assets/img-2.png)

<!-- MD_PACKER_INLINE END -->

3. Access the Bitwarden settings.

<!-- MD_PACKER_INLINE BEGIN -->

![](./assets/img-3.png)

<!-- MD_PACKER_INLINE END -->

4. Copy your Vaultwarden Tor Address from the "Interfaces" section in your Embassy Vaultwarden page and paste it into the “Self Hosted Environment” → “Server URL” field.
**Add “http://” (_not_ https://) to the frontend of the onion URL.**
Then click “Save”.

<!-- MD_PACKER_INLINE BEGIN -->

![](./assets/img-4.png)

<!-- MD_PACKER_INLINE END -->

5. Click “Create Account” and fill in the required fields.

**This _does not_ mean you are creating an account with Bitwarden or any other third party.**
You are creating an account with _yourself_ on your own Embassy.

<!-- MD_PACKER_INLINE BEGIN -->

![](./assets/img-5.png)

<!-- MD_PACKER_INLINE END -->

6. Fill in an email address. This is _only_ used for functions such as 2 Factor Authentication, and it will _only_ be stored on your personal Embassy.
**This is unrelated to any accounts you might have on Bitwarden's premium service.**

7. Fill in a new password for this Bitwarden account. It should be different from your Admin Token.

8. Click “Submit”. You're all set! Now you can log in with your email address and password.

## Admin Portal
## Using The Admin Portal

This portal enables you to configure environment settings, enable or disable new signups, edit users, edit organizations, and more. To use the admin portal:

Expand Down

0 comments on commit 30656fc

Please sign in to comment.