1
0
mirror of https://github.com/bitwarden/server.git synced 2024-11-25 12:45:18 +01:00
bitwarden-server/README.md
2017-08-16 01:03:46 -04:00

51 lines
1.6 KiB
Markdown

[![appveyor build](https://ci.appveyor.com/api/projects/status/github/bitwarden/core?branch=master&svg=true)](https://ci.appveyor.com/project/bitwarden/core/branch/master)
[![Join the chat at https://gitter.im/bitwarden/Lobby](https://badges.gitter.im/bitwarden/Lobby.svg)](https://gitter.im/bitwarden/Lobby)
# bitwarden Core
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**
- [.NET Core 2.x](https://dot.net)
- [SQL Server 2016 or 2017](https://docs.microsoft.com/en-us/sql/index)
**Recommended Development Tooling**
- [Visual Studio](https://www.visualstudio.com/vs/) (Windows and macOS)
- [Visual Studio Code](https://code.visualstudio.com/) (other)
**API**
```
cd src/Api
dotnet restore
dotnet build
dotnet run -f netcoreapp2.0
```
visit http://localhost:5000/alive
**Identity**
```
cd src/Identity
dotnet restore
dotnet build
dotnet run -f netcoreapp2.0
```
visit http://localhost:33657/.well-known/openid-configuration
# Contribute
Code contributions are welcome! Visual Studio or VS Code is required to work 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`](SECURITY.md) file.