The core infrastructure backend (API, database, Docker, etc).
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Kyle Spearrin 74415b9955 script updates 8 years ago
docker script updates 8 years ago
scripts script updates 8 years ago
src script fixes for mac 8 years ago
util new dir for docker env overrides dir 8 years ago
.gitignore script fixes for mac 8 years ago
LICENSE.txt License changed to AGPLv3 9 years ago
NuGet.Config initial commit of source 10 years ago
README.md script updates 8 years ago
SECURITY.md Update SECURITY.md 9 years ago
bitwarden-core.sln stubbed out jobs worker console app 8 years ago
build.ps1 mssql image with setup script on entrypoint 8 years ago
build.sh script fixes for mac 8 years ago

README.md

bitwarden

appveyor build gitter chat


The bitwarden Core project contains the APIs, database, and other infrastructure items needed for the "backend" of all other bitwarden projects.

The core infrastructure is written in C# using .NET Core with ASP.NET Core. The database is written in T-SQL/SQL Server. The codebase can be developed, built, run, and deployed cross-platform on Windows, macOS, and Linux distributions.

Build/Run

Requirements

These dependencies are free to use.

These tools are free to use.

API

cd src/Api
dotnet restore
dotnet build -f netcoreapp2.0
dotnet run -f netcoreapp2.0

visit http://localhost:5000/alive

Identity

cd src/Identity
dotnet restore
dotnet build -f netcoreapp2.0
dotnet run -f netcoreapp2.0

visit http://localhost:33657/.well-known/openid-configuration

Deploy

docker

You can deploy bitwarden using Docker containers on Windows, macOS, and Linux distributions. Use the provided PowerShell and Bash scripts to get started quickly. Find all of the bitwarden images on Docker Hub.

Requirements

These dependencies are free to use.

Linux & macOS

sudo curl -s -o bitwarden.sh https://raw.githubusercontent.com/bitwarden/core/master/scripts/bitwarden.sh && chmod u+x bitwarden.sh

./bitwarden.sh install
./bitwarden.sh updatedb
./bitwarden.sh run

Windows

Invoke-RestMethod -OutFile bitwarden.ps1 -Uri https://raw.githubusercontent.com/bitwarden/core/master/scripts/bitwarden.ps1

.\bitwarden.ps1 -install
.\bitwarden.ps1 -updatedb
.\bitwarden.ps1 -run

Contribute

Code contributions are welcome! Visual Studio or VS Code is highly recommended if you are working on this project. Please commit any pull requests against the master branch.

Security audits and feedback are welcome. Please open an issue or email us privately if the report is sensitive in nature. You can read our security policy in the SECURITY.md file.