ansible-nas/docs/applications/bitwarden.md

# Bitwarden(_rs) Password Management

Homepage: <https://github.com/dani-garcia/bitwarden_rs>

Bitwarden: <https://bitwarden.com/>

This is a Bitwarden server API implementation written in Rust compatible with upstream Bitwarden clients*, perfect for self-hosted deployment where running the official resource-heavy service might not be ideal.

## Usage

Set `bitwarden_enabled: true` in your `inventories/<your_inventory>/nas.yml` file.

## Specific Configuration

Make sure you set your admin token! It is `bitwarden_admin_token` in `group_vars/all.yml` file. The string you put here will be the login to the admin section of your Bitwarden installation (<https://bitwarden.ansiblenasdomain.tld/admin>). This token can be anything, but it's recommended to use a long, randomly generated string of characters, for example running:
`openssl rand -base64 48`.

To create a user, you need to set `bitwarden_allow_signups` to `true` in your `all.yml`, and re-run the playbook to reprovision the container. Once you've created your users, set `bitwarden_allow_signups` back to `false` and run again.

For speed you can target just Bitwarden by appending `-t bitwarden` to your `ansible-playbook` command.
Adding bitwarden documentation 2019-04-10 13:08:06 +00:00			`# Bitwarden(_rs) Password Management`

:recycle: big docs refactoring 2022-07-25 20:18:57 +00:00			`Homepage: <https://github.com/dani-garcia/bitwarden_rs>`

			`Bitwarden: <https://bitwarden.com/>`
Adding bitwarden documentation 2019-04-10 13:08:06 +00:00
			`This is a Bitwarden server API implementation written in Rust compatible with upstream Bitwarden clients*, perfect for self-hosted deployment where running the official resource-heavy service might not be ideal.`

			`## Usage`

Docs inventory reference update 2020-01-25 23:40:26 +00:00			Set `bitwarden_enabled: true` in your `inventories/<your_inventory>/nas.yml` file.
Adding bitwarden documentation 2019-04-10 13:08:06 +00:00
			`## Specific Configuration`

:recycle: big docs refactoring 2022-07-25 20:18:57 +00:00			Make sure you set your admin token! It is `bitwarden_admin_token` in `group_vars/all.yml` file. The string you put here will be the login to the admin section of your Bitwarden installation (<https://bitwarden.ansiblenasdomain.tld/admin>). This token can be anything, but it's recommended to use a long, randomly generated string of characters, for example running:
Push Bitwarden enable/disable signups out to all.yml. 2019-04-14 17:43:41 +00:00			`openssl rand -base64 48`.
Updated bitwarden and documentation 2019-04-10 20:55:14 +00:00
:recycle: big docs refactoring 2022-07-25 20:18:57 +00:00			To create a user, you need to set `bitwarden_allow_signups` to `true` in your `all.yml`, and re-run the playbook to reprovision the container. Once you've created your users, set `bitwarden_allow_signups` back to `false` and run again.
Updated bitwarden and documentation 2019-04-10 20:55:14 +00:00
Documentation fixes: typos, links, whitespace 2019-06-03 15:55:53 +00:00			For speed you can target just Bitwarden by appending `-t bitwarden` to your `ansible-playbook` command.