2018-08-24 08:07:11 -07:00
### This is a Bitwarden server API implementation written in Rust compatible with [upstream Bitwarden clients](https://bitwarden.com/#download)*, perfect for self-hosted deployment where running the official resource-heavy service might not be ideal.
---
[](https://travis-ci.org/dani-garcia/bitwarden_rs)
2019-01-08 12:27:55 -07:00
[](https://hub.docker.com/r/mprasil/bitwarden)
2018-08-24 08:07:11 -07:00
[](https://deps.rs/repo/github/dani-garcia/bitwarden_rs)
[](https://github.com/dani-garcia/bitwarden_rs/releases/latest)
[](https://github.com/dani-garcia/bitwarden_rs/blob/master/LICENSE.txt)
2019-01-08 12:27:55 -07:00
[](https://matrix.to/#/#bitwarden_rs:matrix.org)
2018-02-16 17:13:02 -07:00
2018-05-25 08:15:31 -07:00
Image is based on [Rust implementation of Bitwarden API ](https://github.com/dani-garcia/bitwarden_rs ).
2018-02-09 17:00:55 -07:00
2018-05-25 08:15:31 -07:00
_*Note, that this project is not associated with the [Bitwarden ](https://bitwarden.com/ ) project nor 8bit Solutions LLC._
2018-02-09 17:00:55 -07:00
2018-08-24 08:07:11 -07:00
---
2018-05-25 08:15:31 -07:00
## Features
Basically full implementation of Bitwarden API is provided including:
* Basic single user functionality
* Organizations support
* Attachments
2018-12-15 15:25:17 -07:00
* Vault API support
2018-05-25 08:15:31 -07:00
* Serving the static files for Vault interface
* Website icons API
2018-07-13 06:58:50 -07:00
* Authenticator and U2F support
2018-11-15 18:59:16 -07:00
* YubiKey OTP
2018-12-15 15:25:17 -07:00
2018-12-31 19:03:06 -07:00
## Installation
Pull the docker image and mount a volume from the host for persistent storage:
2018-02-09 17:00:55 -07:00
2018-05-07 12:33:54 -07:00
```sh
2018-05-25 08:15:31 -07:00
docker pull mprasil/bitwarden:latest
docker run -d --name bitwarden -v /bw-data/:/data/ -p 80:80 mprasil/bitwarden:latest
2018-06-29 05:47:23 -07:00
```
2018-12-31 19:03:06 -07:00
This will preserve any persistent data under /bw-data/, you can adapt the path to whatever suits you.
2018-09-03 02:53:52 -07:00
2018-12-31 19:03:06 -07:00
## Usage
See the [bitwarden_rs wiki ](https://github.com/dani-garcia/bitwarden_rs/wiki ) for more information on how to configure and run the bitwarden_rs server.
2018-09-03 02:53:52 -07:00
2018-07-13 02:48:49 -07:00
## Get in touch
To ask an question, [raising an issue ](https://github.com/dani-garcia/bitwarden_rs/issues/new ) is fine, also please report any bugs spotted here.
2018-07-26 14:42:02 -07:00
If you prefer to chat, we're usually hanging around at [#bitwarden_rs:matrix.org ](https://matrix.to/#/#bitwarden_rs:matrix.org ) room on Matrix. Feel free to join us!
