mirror of
https://github.com/dani-garcia/vaultwarden
synced 2024-11-22 11:53:08 +00:00
Added unofficial note and better organized the README file
This commit is contained in:
parent
7c316fc19a
commit
64ac81b9ee
1 changed files with 29 additions and 50 deletions
79
README.md
79
README.md
|
@ -1,53 +1,31 @@
|
||||||
## Easy setup (Docker)
|
|
||||||
Install Docker to your system and then, from the project root, run:
|
# Bitwarden_RS
|
||||||
|
This project is an unofficial implementation of the [Bitwarden Core Server](https://github.com/bitwarden/core) written in [Rust](https://www.rust-lang.org/).
|
||||||
|
|
||||||
|
*(Note: This project is not associated with the [Bitwarden](https://bitwarden.com/) project nor 8bit Solutions LLC.)*
|
||||||
|
|
||||||
|
# Build/Run
|
||||||
|
This project can be built and deployed in two ways:
|
||||||
|
|
||||||
|
## Docker Setup (Easy)
|
||||||
|
Install [Docker](https://www.docker.com/) to your system and then, from the project root, run:
|
||||||
```sh
|
```sh
|
||||||
# Build the docker image:
|
# Build the docker image:
|
||||||
docker build -t dani/bitwarden_rs .
|
docker build -t bitwarden_rs .
|
||||||
|
|
||||||
# Run the docker image with a docker volume:
|
# Run the docker image with a docker volume:
|
||||||
docker volume create bw_data
|
docker run --name bitwarden_rs -t --rm -v bw_data:/data -p 80:80 bitwarden_rs
|
||||||
docker run --name bitwarden_rs -t --init --rm --mount source=bw_data,target=/data -p 8000:80 dani/bitwarden_rs
|
|
||||||
```
|
```
|
||||||
|
Then visit [http://localhost:80](http://localhost:80)
|
||||||
|
|
||||||
#### Other possible Docker options
|
## Manual Setup (Advanced)
|
||||||
|
### Dependencies
|
||||||
|
- `Rust nightly` (strongly recommended to use [rustup](https://rustup.rs/))
|
||||||
|
- `OpenSSL` (should be available in path, install through your system's package manager or use the [prebuilt binaries](https://wiki.openssl.org/index.php/Binaries))
|
||||||
|
- `NodeJS` (required to build the web-vault, (install through your system's package manager or use the [prebuilt binaries](https://nodejs.org/en/download/))
|
||||||
|
|
||||||
To run the container in the background, add the `-d` parameter.
|
### Install the web-vault
|
||||||
|
Download the latest official release from the [releases page](https://github.com/bitwarden/web/releases) and extract it.
|
||||||
To check the logs when in background, run `docker logs bitwarden_rs`
|
|
||||||
|
|
||||||
To stop the container in background, run `docker stop bitwarden_rs`
|
|
||||||
|
|
||||||
To make sure the container is restarted automatically, add the `--restart unless-stopped` parameter
|
|
||||||
|
|
||||||
To run the image with a host bind, change the `--mount` parameter to:
|
|
||||||
```
|
|
||||||
--mount type=bind,source=<absolute_path>,target=/data
|
|
||||||
```
|
|
||||||
Where <absolute_path> is an absolute path in the hosts file system (e.g. C:\bitwarden\data)
|
|
||||||
|
|
||||||
|
|
||||||
## How to compile bitwarden_rs
|
|
||||||
Install `rust nightly`, in Windows the recommended way is through `rustup`.
|
|
||||||
|
|
||||||
Install the `openssl` library, in Windows the best option is Microsoft's `vcpkg`,
|
|
||||||
on other systems use their respective package managers.
|
|
||||||
|
|
||||||
Then run:
|
|
||||||
```sh
|
|
||||||
cargo run
|
|
||||||
# or
|
|
||||||
cargo build
|
|
||||||
```
|
|
||||||
|
|
||||||
## How to install the web-vault locally
|
|
||||||
If you're using docker image, you can just update `VAULT_VERSION` variable in Dockerfile and rebuild the image.
|
|
||||||
|
|
||||||
Install `node.js` and either `yarn` or `npm` (usually included with node)
|
|
||||||
|
|
||||||
Clone the web-vault outside the project:
|
|
||||||
```
|
|
||||||
git clone https://github.com/bitwarden/web.git web-vault
|
|
||||||
```
|
|
||||||
|
|
||||||
Modify `web-vault/settings.Production.json` to look like this:
|
Modify `web-vault/settings.Production.json` to look like this:
|
||||||
```json
|
```json
|
||||||
|
@ -62,20 +40,21 @@ Modify `web-vault/settings.Production.json` to look like this:
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
Then, run the following from the `web-vault` dir:
|
Then, run the following from the `web-vault` directory:
|
||||||
```sh
|
```sh
|
||||||
# With yarn (recommended)
|
|
||||||
yarn
|
|
||||||
yarn gulp dist:selfHosted
|
|
||||||
|
|
||||||
# With npm
|
|
||||||
npm install
|
npm install
|
||||||
npx gulp dist:selfHosted
|
npx gulp dist:selfHosted
|
||||||
```
|
```
|
||||||
|
|
||||||
Finally copy the contents of the `web-vault/dist` folder into the `bitwarden_rs/web-vault` folder.
|
Finally copy the contents of the `web-vault/dist` folder into the `bitwarden_rs/web-vault` folder.
|
||||||
|
|
||||||
## How to recreate database schemas
|
### Running
|
||||||
|
```sh
|
||||||
|
cargo run
|
||||||
|
```
|
||||||
|
Then visit [http://localhost:80](http://localhost:80)
|
||||||
|
|
||||||
|
## How to recreate database schemas (for developers)
|
||||||
Install diesel-cli with cargo:
|
Install diesel-cli with cargo:
|
||||||
```sh
|
```sh
|
||||||
cargo install diesel_cli --no-default-features --features sqlite-bundled
|
cargo install diesel_cli --no-default-features --features sqlite-bundled
|
||||||
|
|
Loading…
Reference in a new issue