diff --git a/website/developer-docs/full-dev-environment.md b/website/developer-docs/full-dev-environment.md index cfb14bdd..5dea10d0 100644 --- a/website/developer-docs/full-dev-environment.md +++ b/website/developer-docs/full-dev-environment.md @@ -8,6 +8,7 @@ To create a local development setup for authentik, you need the following: - Python 3.9 - pipenv, which is used to manage dependencies, and can be installed with `pip install pipenv` +- Go 1.16 - PostgreSQL (any recent version will do) - Redis (any recent version will do) @@ -24,11 +25,13 @@ log_level: debug secret_key: "A long key you can generate with `pwgen 40 1` for example" ``` -Afterwards, you can start authentik by running `./manage.py runserver`. Generally speaking, authentik is a Django application. +Afterwards, you can start authentik by running `make run`. + +Generally speaking, authentik is a Django application, ran by gunicorn, proxied by a Go application. The Go application serves static files. Most functions and classes have type-hints and docstrings, so it is recommended to install a Python Type-checking Extension in your IDE to navigate around the code. -Before committing code, run `make lint` to ensure your code is formatted well. This also requires `pyright`, which can be installed with npm. +Before committing code, run `make lint` to ensure your code is formatted well. This also requires `pyright@1.1.136`, which can be installed with npm. Run `make gen` to generate an updated OpenAPI document for any changes you made.