aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorDaniel García <[email protected]>2018-07-13 15:58:50 +0200
committerDaniel García <[email protected]>2018-07-13 15:58:50 +0200
commit819622e31034a1d7f1c4a8445c7b1afcaac06f65 (patch)
tree826ea496fbbc1992ec3fa70abaca1fbe61750c33 /README.md
parent970863ffb1b2524bce17964648b131a5c165a9ba (diff)
downloadvaultwarden-819622e31034a1d7f1c4a8445c7b1afcaac06f65.tar.gz
vaultwarden-819622e31034a1d7f1c4a8445c7b1afcaac06f65.zip
Documented U2F, removed debug prints, and documented missing features
Diffstat (limited to 'README.md')
-rw-r--r--README.md71
1 files changed, 48 insertions, 23 deletions
diff --git a/README.md b/README.md
index 0351a30e..f78e15be 100644
--- a/README.md
+++ b/README.md
@@ -11,13 +11,14 @@ _*Note, that this project is not associated with the [Bitwarden](https://bitward
- [Updating the bitwarden image](#updating-the-bitwarden-image)
- [Configuring bitwarden service](#configuring-bitwarden-service)
- [Disable registration of new users](#disable-registration-of-new-users)
+ - [Enabling HTTPS](#enabling-https)
+ - [Enabling U2F authentication](#enabling-u2f-authentication)
- [Changing persistent data location](#changing-persistent-data-location)
- [/data prefix:](#data-prefix)
- [database name and location](#database-name-and-location)
- [attachments location](#attachments-location)
- [icons cache](#icons-cache)
- [Changing the API request size limit](#changing-the-api-request-size-limit)
- - [Enabling HTTPS](#enabling-https)
- [Other configuration](#other-configuration)
- [Building your own image](#building-your-own-image)
- [Building binary](#building-binary)
@@ -41,6 +42,14 @@ Basically full implementation of Bitwarden API is provided including:
* Vault API support
* Serving the static files for Vault interface
* Website icons API
+ * Authenticator and U2F support
+
+## Missing features
+* Email confirmation
+* Other two-factor systems:
+ * YubiKey OTP (if your key supports U2F, you can use that)
+ * Duo
+ * Email codes
## Docker image usage
@@ -109,6 +118,44 @@ docker run -d --name bitwarden \
mprasil/bitwarden:latest
```
+### Enabling HTTPS
+To enable HTTPS, you need to configure the `ROCKET_TLS`.
+
+The values to the option must follow the format:
+```
+ROCKET_TLS={certs="/path/to/certs.pem",key="/path/to/key.pem"}
+```
+Where:
+- certs: a path to a certificate chain in PEM format
+- key: a path to a private key file in PEM format for the certificate in certs
+
+```sh
+docker run -d --name bitwarden \
+ -e ROCKET_TLS={certs='"/ssl/certs.pem",key="/ssl/key.pem"}' \
+ -v /ssl/keys/:/ssl/ \
+ -v /bw-data/:/data/ \
+ -v /icon_cache/ \
+ -p 443:443 \
+ mprasil/bitwarden:latest
+```
+Note that you need to mount ssl files and you need to forward appropriate port.
+
+### Enabling U2F authentication
+To enable U2F authentication, you must be serving bitwarden_rs from an HTTPS domain with a valid certificate (Either using the included
+HTTPS options or with a reverse proxy). We recommend using a free certificate from Let's Encrypt.
+
+After that, you need to set the `DOMAIN` environment variable to the same address from where bitwarden_rs is being served:
+
+```sh
+docker run -d --name bitwarden \
+ -e DOMAIN=https://bw.domain.tld \
+ -v /bw-data/:/data/ \
+ -p 80:80 \
+ mprasil/bitwarden:latest
+```
+
+Note that the value has to include the `https://` and it may include a port at the end (in the format of `https://bw.domain.tld:port`) when not using `443`.
+
### Changing persistent data location
#### /data prefix:
@@ -184,28 +231,6 @@ docker run -d --name bitwarden \
mprasil/bitwarden:latest
```
-### Enabling HTTPS
-To enable HTTPS, you need to configure the `ROCKET_TLS`.
-
-The values to the option must follow the format:
-```
-ROCKET_TLS={certs="/path/to/certs.pem",key="/path/to/key.pem"}
-```
-Where:
-- certs: a path to a certificate chain in PEM format
-- key: a path to a private key file in PEM format for the certificate in certs
-
-```sh
-docker run -d --name bitwarden \
- -e ROCKET_TLS={certs='"/ssl/certs.pem",key="/ssl/key.pem"}' \
- -v /ssl/keys/:/ssl/ \
- -v /bw-data/:/data/ \
- -v /icon_cache/ \
- -p 443:443 \
- mprasil/bitwarden:latest
-```
-Note that you need to mount ssl files and you need to forward appropriate port.
-
### Other configuration
Though this is unlikely to be required in small deployment, you can fine-tune some other settings like number of workers using environment variables that are processed by [Rocket](https://rocket.rs), please see details in [documentation](https://rocket.rs/guide/configuration/#environment-variables).