selfprivacy.org/content/en/docs/Services/bitwarden.md

---
title: "Bitwarden"
date: 2023-01-11T18:09:37+03:00
weight: 7
description: >
  Your password manager 
---

Information security experts recommend using complex passwords and creating a unique one for each account. Even three or four passwords are difficult to remember, so people often use the same password or similar ones. A password manager solves this problem: it generates complex passwords and stores them in a convenient form. 

[Bitwarden](https://bitwarden.com/open-source/) can be downloaded and configured on your server, which is what we use as part of the SelfPrivacy project. Unlike other free (like freedom) password managers, Bitwarden provides easy synchronization of one database between all devices.

- [Official project website](https://bitwarden.com/open-source/)

## Recommended clients
- WEB-interface: available after SelfPrivacy server configuration, at `https://password.YOUR.DOMAIN`
- [Official client](https://bitwarden.com/download/) (GNU/Linux, Windows, macOS, Android, iOS)

## Setting an admin token manually

First, make sure your system config is up to date. You may click "upgrade server" in the app and wait for a couple of minutes, or run the following command in the terminal:

```bash
cd /etc/nixos
git pull
```

Then, we have to generate an admin token. Run the following:

```bash
nix-shell -p openssl --run 'openssl rand -base64 48'
```

It will output a string like this:

```
47pFSgYBbS0G0vCG63nX1yyblzgNaqZ40bNuJnwq2hvOy8ABfe+iHRfBeXlfrRdJ
```

This will be a password to your admin account. Copy it and paste it somewhere safe. To set it, we will run the following, replacing `PASSWORD` with the password you just generated:

```bash
jq '.bitwarden.adminToken = "PASSWORD"' /etc/nixos/userdata/userdata.json > /etc/nixos/userdata/userdata.json.new && mv /etc/nixos/userdata/userdata.json.new /etc/nixos/userdata/userdata.json
```

Now, we have to apply the changes:

```bash
nixos-rebuild switch
```

And after rebuilding the system, restart Bitwarden:

```bash
systemctl restart vaultwarden
```

Now, your admin interface is available on `https://password.YOUR.DOMAIN/admin`.
feat: Switch to docsy 2023-01-11 16:53:46 +00:00			`---`
			`title: "Bitwarden"`
			`date: 2023-01-11T18:09:37+03:00`
fix(docs): reorder toc 2024-04-08 01:41:59 +00:00			`weight: 7`
feat: Switch to docsy 2023-01-11 16:53:46 +00:00			`description: >`
finally brought two languages into a single view 2023-05-18 02:57:31 +00:00			`Your password manager`
feat: Switch to docsy 2023-01-11 16:53:46 +00:00			`---`

update serveces ru 2023-05-11 22:58:39 +00:00			`Information security experts recommend using complex passwords and creating a unique one for each account. Even three or four passwords are difficult to remember, so people often use the same password or similar ones. A password manager solves this problem: it generates complex passwords and stores them in a convenient form.`

fix typos, remove emoji 2023-05-17 17:33:53 +00:00			`[Bitwarden](https://bitwarden.com/open-source/) can be downloaded and configured on your server, which is what we use as part of the SelfPrivacy project. Unlike other free (like freedom) password managers, Bitwarden provides easy synchronization of one database between all devices.`
docs(en): Bitwarden admin token guide 2023-05-03 07:56:10 +00:00
finally brought two languages into a single view 2023-05-18 02:57:31 +00:00			`- [Official project website](https://bitwarden.com/open-source/)`

			`## Recommended clients`
			- WEB-interface: available after SelfPrivacy server configuration, at `https://password.YOUR.DOMAIN`
			`- [Official client](https://bitwarden.com/download/) (GNU/Linux, Windows, macOS, Android, iOS)`

docs(en): Bitwarden admin token guide 2023-05-03 07:56:10 +00:00			`## Setting an admin token manually`

			`First, make sure your system config is up to date. You may click "upgrade server" in the app and wait for a couple of minutes, or run the following command in the terminal:`

			```bash
			`cd /etc/nixos`
			`git pull`
			```

			`Then, we have to generate an admin token. Run the following:`

			```bash
			`nix-shell -p openssl --run 'openssl rand -base64 48'`
			```

			`It will output a string like this:`

			```
			`47pFSgYBbS0G0vCG63nX1yyblzgNaqZ40bNuJnwq2hvOy8ABfe+iHRfBeXlfrRdJ`
			```

			This will be a password to your admin account. Copy it and paste it somewhere safe. To set it, we will run the following, replacing `PASSWORD` with the password you just generated:

			```bash
			`jq '.bitwarden.adminToken = "PASSWORD"' /etc/nixos/userdata/userdata.json > /etc/nixos/userdata/userdata.json.new && mv /etc/nixos/userdata/userdata.json.new /etc/nixos/userdata/userdata.json`
			```

			`Now, we have to apply the changes:`

			```bash
			`nixos-rebuild switch`
			```

			`And after rebuilding the system, restart Bitwarden:`

			```bash
			`systemctl restart vaultwarden`
			```

			Now, your admin interface is available on `https://password.YOUR.DOMAIN/admin`.