What is this?
This is the server side of Bitwarden, the password manager: the APIs, database, and core backend infrastructure that all Bitwarden client apps talk to. Run it on your own hardware to get your own Bitwarden instance.
This is the server side of Bitwarden, the password manager: the APIs, database, and core backend infrastructure that all Bitwarden client apps talk to. Run it on your own hardware to get your own Bitwarden instance.So it's not the app itself — what exactly would I be running?The client apps are separate projects; this repo is the backend they connect to. It's written in C# on .NET with ASP.NET Core, uses a T-SQL/SQL Server database, and ships as Docker containers.
The client apps are separate projects; this repo is the backend they connect to. It's written in C# on .NET with ASP.NET Core, uses a T-SQL/SQL Server database, and ships as Docker containers.How do I get my own instance up and running?With Docker: install Docker and Docker Compose, then run the provided Bash (Linux/macOS) or PowerShell (Windows) scripts to pull the images from GitHub Container Registry and start the stack.
With Docker: install Docker and Docker Compose, then run the provided Bash (Linux/macOS) or PowerShell (Windows) scripts to pull the images from GitHub Container Registry and start the stack.What do I need to have installed beforehand?Just Docker and Docker Compose, and Compose already comes bundled with some Docker installations. Both are free to use.
Just Docker and Docker Compose, and Compose already comes bundled with some Docker installations. Both are free to use.Any gotchas before I commit to self-hosting it?Docker is the only deployment path the README documents, so a working Docker + Compose setup is a hard prerequisite. And since it becomes your password server, upkeep like updates and backups is on you.
Docker is the only deployment path the README documents, so a working Docker + Compose setup is a hard prerequisite. And since it becomes your password server, upkeep like updates and backups is on you.Is there a catch in the licensing or trademarks?The README names no code license, but it sets one boundary: no rights in Bitwarden trademarks, service marks, or logos are granted, so any use of the brand must follow their Trademark Guidelines.
The README names no code license, but it sets one boundary: no rights in Bitwarden trademarks, service marks, or logos are granted, so any use of the brand must follow their Trademark Guidelines.What services make up a full deployment?Each component ships as its own container: alongside the main API there are Identity, SSO, SCIM, Notifications, Events, EventsProcessor, Billing, and an Admin portal — the full set Bitwarden publishes production image hashes for.
Each component ships as its own container: alongside the main API there are Identity, SSO, SCIM, Notifications, Events, EventsProcessor, Billing, and an Admin portal — the full set Bitwarden publishes production image hashes for.Is this what actually runs Bitwarden's hosted service?Close — the README publishes current production image hashes for Bitwarden's US and EU clusters covering exactly these services, so the images this repo builds are the ones behind the hosted product.
Close — the README publishes current production image hashes for Bitwarden's US and EU clusters covering exactly these services, so the images this repo builds are the ones behind the hosted product.Can I develop and build it on any OS?Yes: the codebase can be developed, built, run, and deployed cross-platform on Windows, macOS, and Linux. The Contributing Documentation's Server Setup Guide covers build instructions and tooling, plus an optional git pre-commit hook for dotnet-format.
Yes: the codebase can be developed, built, run, and deployed cross-platform on Windows, macOS, and Linux. The Contributing Documentation's Server Setup Guide covers build instructions and tooling, plus an optional git pre-commit hook for dotnet-format.What are similar projects?nopCommerce, aspnetboilerplate, efcore, abp, Smartstore, dotnet-framework-docker, practical-aspnetcore, aspnetcore
nopCommerce, aspnetboilerplate, efcore, abp, Smartstore, dotnet-framework-docker, practical-aspnetcore, aspnetcoreWhich topics is it in?api-server, aspnet, aspnetcore, sqlserver, password-manager, sql-server, dotnet-core, c-sharp, sso, self-hosting, microsoft, dotnet
api-server, aspnet, aspnetcore, sqlserver, password-manager, sql-server, dotnet-core, c-sharp, sso, self-hosting, microsoft, dotnet