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.
 
 
 
 
 
 
Rui Tomé 038d5e7734
[EC-276] Admin with custom permission is unable to manage all collections (#2143)
3 weeks ago
.config [PS-40] Upgrade to .NET 6 (#2056) 2 months ago
.github [ENG-71] Updated release job to create and update Github deployment for Jira integration (#2141) 3 weeks ago
.vscode Fix VSCode Launch file (#2077) 2 months ago
bitwarden_license [EC-338] Update SCIM code naming conventions (revoked/restore) (#2140) 3 weeks ago
dev [EC-261] SCIM (#2105) 1 month ago
scripts New Self Host Stub Scripts (#1893) 6 months ago
src [EC-276] Admin with custom permission is unable to manage all collections (#2143) 3 weeks ago
test Re-evaluate lock files to ensure they match project dependencies (#2132) 4 weeks ago
util [EC-247] Add columns to provider portal clients table (#2136) 3 weeks ago
.editorconfig Turn On `ImplicitUsings` (#2079) 2 months ago
.git-blame-ignore-revs Add .git-blame-ignore-revs (#1771) 8 months ago
.gitattributes Run dotnet format (#1764) 8 months ago
.gitignore revamping the build scripts (#1620) 10 months ago
CONTRIBUTING.md Update README and CONTRIBUTING to point to contributing.bitwarden.com (#2028) 2 months ago
Directory.Build.props Bump version to 2022.6.2 (#2111) 1 month ago
LICENSE.txt Update LICENSE.txt 1 year ago
LICENSE_AGPL.txt split license file out to support bitwarden licensed code (#912) 2 years ago
LICENSE_BITWARDEN.txt Update LICENSE_BITWARDEN.txt 1 year ago
LICENSE_FAQ.md Remove Business Portal (#1614) 11 months ago
NuGet.Config initial commit of source 7 years ago
README.md Update README and CONTRIBUTING to point to contributing.bitwarden.com (#2028) 2 months ago
SECURITY.md Update SECURITY.md (#1913) 5 months ago
TRADEMARK_GUIDELINES.md Update TRADEMARK_GUIDELINES.md 1 year ago
bitwarden-server.sln [EC-261] SCIM (#2105) 1 month ago

README.md

Bitwarden

Github Workflow build on master DockerHub gitter chat


The Bitwarden Server project contains the APIs, database, and other core infrastructure items needed for the "backend" of all bitwarden client applications.

The server project 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.

Developer Documentation

Please refer to the Server Setup Guide in the Contributing Documentation for build instructions, recommended tooling, code style tips, and lots of other great information to get you started.

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.

Full documentation for deploying Bitwarden with Docker can be found in our help center at: https://help.bitwarden.com/article/install-on-premise/

Requirements

These dependencies are free to use.

Linux & macOS

curl -s -o bitwarden.sh \
    https://raw.githubusercontent.com/bitwarden/server/master/scripts/bitwarden.sh \
    && chmod +x bitwarden.sh
./bitwarden.sh install
./bitwarden.sh start

Windows

Invoke-RestMethod -OutFile bitwarden.ps1 `
    -Uri https://raw.githubusercontent.com/bitwarden/server/master/scripts/bitwarden.ps1
.\bitwarden.ps1 -install
.\bitwarden.ps1 -start

We're Hiring!

Interested in contributing in a big way? Consider joining our team! We're hiring for many positions. Please take a look at our Careers page to see what opportunities are currently open as well as what it's like to work at Bitwarden.

Contribute

Code contributions are welcome! Please commit any pull requests against the master branch. Learn more about how to contribute by reading the Contributing Guidelines. Check out the Contributing Documentation for how to get started with your first contribution.

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. We also run a program on HackerOne.

No grant of any rights in the trademarks, service marks, or logos of Bitwarden is made (except as may be necessary to comply with the notice requirements as applicable), and use of any Bitwarden trademarks must comply with Bitwarden Trademark Guidelines.

Dotnet-format

We recently migrated to using dotnet-format as code formatter. All previous branches will need to updated to avoid large merge conflicts using the following steps:

  1. Check out your local Branch
  2. Run git merge 61dc65aa598b1f492d2f0222bb7bf0dd15d116f5
  3. Resolve any merge conflicts, commit.
  4. Run dotnet tool run dotnet-format
  5. Commit
  6. Run git merge -Xours 23b0a1f9df25058ab29785ecad9a233113c10889
  7. Push