commit c6c6b17a23c0b5c6daf91b066ebe1bb571eae69a Author: MrMeeb Date: Mon May 6 11:47:50 2024 +0000 Add README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..7e6681e --- /dev/null +++ b/README.md @@ -0,0 +1,29 @@ +# PyWebfinger + +A Python webserver that loosely implements the Webfinger spec [RFC7033](https://www.rfc-editor.org/rfc/rfc7033#section-3.0). + +Shamelessly stolen from [this Authentik GitHub issue](https://github.com/goauthentik/authentik/issues/5440#issuecomment-1682856454) while I wait for Authentik to provide something themselves. Some small modifications were made to make it configurable using environment variables. + +A healtcheck endpoint was also added to ensure everything is running smoothly. + +## Running + +### Docker CLI +```bash +docker run -d --name pywebfinger \ + -e ISSUER_URL=https://auth.example.com/application/o/example/ + -p 8000:8000 + git.mrmeeb.stream/mrmeeb/pywebfinger:latest +``` +### Docker Compose +```yaml +services: + pywebfinger: + image: git.mrmeeb.stream/pywebfinger:latest + container_name: pywebfinger + restart: unless-stopped + ports: + - 8000:8000 + environment: + - ISSUER_URL=https://auth.example.com/application/o/example/ +``` \ No newline at end of file