Skip to content
Unofficial Bitwarden compatible server written in Rust
Branch: master
Clone or download
dani-garcia Merge pull request #484 from mprasil/hub_repo_change
Point to the new docker hub image location
Latest commit 08a445e May 17, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
migrations Fix attachments during key rotation, add individual attachment key Nov 27, 2018
src Update ring to 0.14, jwt to 6.0, and u2f May 11, 2019
.dockerignore Include git repo in build so we get version Feb 16, 2019
.env.template Updated .env template Apr 27, 2019
.gitignore Rename included .env file to .env.template and ignored .env Jan 6, 2019
.travis.yml Remove verbose, otherwise the logs get filled with useless info Feb 22, 2019
Cargo.lock Update deps and swap back to official u2f crate again May 17, 2019
Cargo.toml Update deps and swap back to official u2f crate again May 17, 2019
Dockerfile New vault patch release May 15, 2019
Dockerfile.aarch64 New vault patch release May 15, 2019
Dockerfile.alpine New vault patch release May 15, 2019
Dockerfile.armv6 New vault patch release May 15, 2019
Dockerfile.armv7 New vault patch release May 15, 2019
LICENSE.txt Upload and download attachments, and added License file Feb 14, 2018
README.md Point to the new docker hub image location May 16, 2019
Rocket.toml Document configuration a bit and increase JSON size limit to 10MB Jun 29, 2018
azure-pipelines.yml Remove verbose, otherwise the logs get filled with useless info Feb 22, 2019
build.rs Show version in admin panel Feb 10, 2019
diesel.toml Updated dependencies and created 'rust-toolchain', to mark a working … Jun 12, 2018
rust-toolchain Updated web vault to hide org plans again and updated dependencies May 11, 2019
rustfmt.toml Start using rustfmt and some style changes to make some lines shorter Dec 30, 2018

README.md

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.


Travis Build Status Docker Pulls Dependency Status GitHub Release GPL-3.0 Licensed Matrix Chat

Image is based on Rust implementation of Bitwarden API.

This project is not associated with the Bitwarden project nor 8bit Solutions LLC.

⚠️IMPORTANT⚠️: When using this server, please report any Bitwarden related bug-reports or suggestions here, regardless of whatever clients you are using (mobile, desktop, browser...). DO NOT use the official support channels.


Features

Basically full implementation of Bitwarden API is provided including:

  • Basic single user functionality
  • Organizations support
  • Attachments
  • Vault API support
  • Serving the static files for Vault interface
  • Website icons API
  • Authenticator and U2F support
  • YubiKey OTP

Installation

Pull the docker image and mount a volume from the host for persistent storage:

docker pull bitwardenrs/server:latest
docker run -d --name bitwarden -v /bw-data/:/data/ -p 80:80 bitwardenrs/server:latest

This will preserve any persistent data under /bw-data/, you can adapt the path to whatever suits you.

IMPORTANT: Some web browsers, like Chrome, disallow the use of Web Crypto APIs in insecure contexts. In this case, you might get an error like Cannot read property 'importKey'. To solve this problem, you need to access the web vault from HTTPS.

This can be configured in bitwarden_rs directly or using a third-party reverse proxy (some examples).

If you have an available domain name, you can get HTTPS certificates with Let's Encrypt, or you can generate self-signed certificates with utilities like mkcert. Some proxies automatically do this step, like Caddy (see examples linked above).

Usage

See the bitwarden_rs wiki for more information on how to configure and run the bitwarden_rs server.

Get in touch

To ask an question, raising an issue is fine, also please report any bugs spotted here.

If you prefer to chat, we're usually hanging around at #bitwarden_rs:matrix.org room on Matrix. Feel free to join us!

You can’t perform that action at this time.