Add README.md

This commit is contained in:
Tracker-Friendly 2024-06-26 00:02:25 +01:00
parent 1c6f66c3ae
commit ae288f19d7
1 changed files with 15 additions and 0 deletions

15
README.md Normal file
View File

@ -0,0 +1,15 @@
# Burgerauth
Burgerauth is a free-and-open-source OAuth2 server.
## Ok, that's great, how do I host my own instance?
First, replace the domains in the source code and templates with your own (a domain is required, not just an IP). Second, copy confit.ini.example to config.ini then tweak to your liking. Third, run `go build`, and fourth, run `./burgerauth`. Read ERRORS.md to see how to handle server errors.
## What if I am a developer?
The OAuth2 protocol should be fairly standard. Burgerauth comes with OpenID Connect discovery, and you should use that to find out the URL endpoints for the instance you are targeting, and you shouldn't really touch anything else. Burgerauth provides only authorization and not resource-delegation, and so doesn't issue refresh tokens.
## How long did this take to make?
Yes.