ansible-nas/website/docs/applications/other/bitwarden.md

23 lines
1.3 KiB
Markdown
Raw Normal View History

2022-09-20 22:00:57 +00:00
---
title: "Bitwarden(_rs)"
---
2019-04-10 13:08:06 +00:00
Homepage: [https://github.com/dani-garcia/bitwarden_rs](https://github.com/dani-garcia/bitwarden_rs)
2022-07-25 20:18:57 +00:00
Bitwarden: [https://bitwarden.com/](https://bitwarden.com/)
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
Set `bitwarden_enabled: true` in your `inventories/<your_inventory>/group_vars/nas.yml` file.
2019-04-10 13:08:06 +00:00
## 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](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`.
2019-04-10 20:55:14 +00:00
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.
2019-04-10 20:55:14 +00:00
For speed you can target just Bitwarden by appending `-t bitwarden` to your `ansible-playbook` command.