internal: use config system for workers/threads, document the settings (#3626)

use config system for workers/threads, document the settings

Signed-off-by: Jens Langhammer <jens.langhammer@beryju.org>

Signed-off-by: Jens Langhammer <jens.langhammer@beryju.org>

website/docs/installation/configuration.md

@@ -15,6 +15,16 @@ All of these variables can be set to values, but you can also use a URI-like for
 -   `env://<name>` Loads the value from the environment variable `<name>`. Fallback can be optionally set like `env://<name>?<default>`
 -   `file://<name>` Loads the value from the file `<name>`. Fallback can be optionally set like `file://<name>?<default>`
 
+## Checking settings
+
+To check if your config has been applied correctly, you can run the following command to output the full config:
+
+```
+docker-compose run --rm worker dump_config
+# Or for kubernetes
+kubectl exec -it deployment/authentik-worker -c authentik -- ak dump_config
+```
+
 ## PostgreSQL Settings
 
 -   `AUTHENTIK_POSTGRESQL__HOST`: Hostname of your PostgreSQL Server
@@ -233,12 +243,23 @@ Allows configuration of TLS Cliphers for LDAP connections used by LDAP sources.
 
 Defaults to `null`.
 
-## Debugging
+### `AUTHENTIK_WEB__WORKERS`
 
-To check if your config has been applied correctly, you can run the following command to output the full config:
+:::info
+Requires authentik 2022.9
+:::
 
-```
-docker-compose run --rm worker dump_config
-# Or for kubernetes
-kubectl exec -it deployment/authentik-worker -c authentik -- ak dump_config
-```
+Configure how many gunicorn worker processes should be started (see https://docs.gunicorn.org/en/stable/design.html).
+
+If running in Kubernetes, the default value is set to 2 and should in most cases not be changed, as scaling can be done with multiple pods running the web server.
+Otherwise, authentik will use 1 worker for each 4 CPU cores + 1 as a value below 2 workers is not recommended.
+
+### `AUTHENTIK_WEB__THREADS`
+
+:::info
+Requires authentik 2022.9
+:::
+
+Configure how many gunicorn threads a worker processes should have (see https://docs.gunicorn.org/en/stable/design.html).
+
+Defaults to 4.

website/docs/releases/v2022.9.md

@@ -3,6 +3,10 @@ title: Release 2022.9
 slug: "2022.9"
 ---
 
+## Breaking changes
+
+-   `WORKERS` environment variable has been renamed to match other config options, see [Configuration](../installation/configuration#authentik_web__workers)
+
 ## New features
 
 -   UI for Duo device Import