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.
 
 
 
 
 
 
Jared Snider b412a01d2a
Defect/SG-992 ProviderOrgs Missing Plan Type & EC-591/SG-996 - Provider Org Autoscaling Email Invites Working (#2596)
1 day ago
.config Upgrade Swagger (#2611) 3 days ago
.git-hooks Add git hook for formating (#2224) 5 months ago
.github [SM-460] Isolate SecretsManager files (#2616) 3 days ago
.vscode [SG-419] Fix problems with push notifications on self-host (#2338) 3 months ago
bitwarden_license [SM-460] Isolate SecretsManager files (#2616) 3 days ago
dev Add Tool For Adding EF Migrations (#2576) 1 week ago
docker-unified Quotes break adminSettings__admins (#2572) 5 days ago
perf/MicroBenchmarks Upgrade FIDO2 library usage out of beta (#2579) 1 week ago
scripts Bitwarden Unified Self-Host project (#2410) 2 months ago
src Defect/SG-992 ProviderOrgs Missing Plan Type & EC-591/SG-996 - Provider Org Autoscaling Email Invites Working (#2596) 1 day ago
test Defect/SG-992 ProviderOrgs Missing Plan Type & EC-591/SG-996 - Provider Org Autoscaling Email Invites Working (#2596) 1 day ago
util Defect/SG-992 ProviderOrgs Missing Plan Type & EC-591/SG-996 - Provider Org Autoscaling Email Invites Working (#2596) 1 day ago
.dockerignore Bitwarden Unified Self-Host project (#2410) 2 months ago
.editorconfig [SM-380] Access checks for listing projects (#2496) 1 week ago
.git-blame-ignore-revs Add instructions (#2232) 5 months ago
.gitattributes Run dotnet format (#1764) 1 year ago
.gitignore revamping the build scripts (#1620) 1 year ago
CONTRIBUTING.md Update README and CONTRIBUTING to point to contributing.bitwarden.com (#2028) 8 months ago
Directory.Build.props Bump version to 2023.1.0 (#2562) 2 weeks ago
LICENSE.txt Update LICENSE.txt 2 years ago
LICENSE_AGPL.txt
LICENSE_BITWARDEN.txt Update LICENSE_BITWARDEN.txt 2 years ago
LICENSE_FAQ.md [SM-142] Rename CommCore to Commercial.Core (#2158) 6 months ago
NuGet.Config
README.md Update README example commands for self-host scripts (#2620) 3 days ago
SECURITY.md Update SECURITY.md (#1913) 11 months ago
TRADEMARK_GUIDELINES.md
bitwarden-server.sln [SM-394] Secrets Manager (#2164) 2 weeks 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 -L -o bitwarden.sh \
    "https://func.bitwarden.com/api/dl/?app=self-host&platform=linux" \
    && chmod +x bitwarden.sh
./bitwarden.sh install
./bitwarden.sh start

Windows

Invoke-RestMethod -OutFile bitwarden.ps1 `
    -Uri "https://func.bitwarden.com/api/dl/?app=self-host&platform=windows"
.\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

Consider installing our git pre-commit hook for automatic formatting.

git config --local core.hooksPath .git-hooks

File Scoped Namespaces

We recently migrated to using file scoped namespaces to save some horizontal space. All previous branches will need to update to avoid large merge conflicts using the following steps:

  1. Check out your local Branch
  2. Run git merge 9b7aef0763ad14e229b337c3b5b27cb411009792
  3. Resolve any merge conflicts, commit.
  4. Run dotnet format
  5. Commit
  6. Run git merge -Xours 7f5f010e1eea400300c47f776604ecf46c4b4f2d
  7. Fix Merge conflicts
  8. Push