2021-03-12 15:43:31 +00:00
|
|
|
---
|
2021-05-05 17:52:07 +00:00
|
|
|
title: Configuration
|
2021-03-12 15:43:31 +00:00
|
|
|
---
|
|
|
|
|
2021-05-05 17:52:07 +00:00
|
|
|
These are all the configuration options you can set via environment variables.
|
2021-03-12 15:43:31 +00:00
|
|
|
|
|
|
|
Append any of the following keys to your `.env` file, and run `docker-compose up -d` to apply them.
|
|
|
|
|
2021-05-08 15:14:14 +00:00
|
|
|
:::info
|
|
|
|
The double-underscores are intentional, as all these settings are translated to yaml internally, a double-underscore indicates the next level.
|
|
|
|
:::
|
|
|
|
|
|
|
|
All of these variables can be set to values, but you can also use a URI-like format to load values from other places:
|
|
|
|
|
|
|
|
- `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>`
|
|
|
|
|
|
|
|
## PostgreSQL Settings
|
|
|
|
|
|
|
|
- `AUTHENTIK_POSTGRESQL__HOST`: Hostname of your PostgreSQL Server
|
|
|
|
- `AUTHENTIK_POSTGRESQL__NAME`: Database name
|
|
|
|
- `AUTHENTIK_POSTGRESQL__USER`: Database user
|
|
|
|
- `AUTHENTIK_POSTGRESQL__PASSWORD`: Database password, defaults to the environment variable `POSTGRES_PASSWORD`
|
|
|
|
|
|
|
|
## Redis Settings
|
|
|
|
|
|
|
|
- `AUTHENTIK_REDIS__HOST`: Hostname of your Redis Server
|
|
|
|
- `AUTHENTIK_REDIS__PASSWORD`: Password for your Redis Server
|
|
|
|
- `AUTHENTIK_REDIS__CACHE_DB`: Database for caching, defaults to 0
|
|
|
|
- `AUTHENTIK_REDIS__MESSAGE_QUEUE_DB`: Database for the message queue, defaults to 1
|
|
|
|
- `AUTHENTIK_REDIS__WS_DB`: Database for websocket connections, defaults to 2
|
|
|
|
|
|
|
|
## authentik Settings
|
|
|
|
|
|
|
|
### AUTHENTIK_LOG_LEVEL
|
2021-03-12 15:43:31 +00:00
|
|
|
|
|
|
|
Log level for the server and worker containers. Possible values: debug, info, warning, error
|
|
|
|
Defaults to `info`.
|
|
|
|
|
2021-05-08 15:14:14 +00:00
|
|
|
### AUTHENTIK_ERROR_REPORTING
|
2021-03-12 15:43:31 +00:00
|
|
|
|
2021-04-22 20:31:24 +00:00
|
|
|
- `AUTHENTIK_ERROR_REPORTING__ENABLED`
|
2021-03-12 15:43:31 +00:00
|
|
|
|
|
|
|
Enable error reporting. Defaults to `false`.
|
|
|
|
|
|
|
|
Error reports are sent to https://sentry.beryju.org, and are used for debugging and general feedback. Anonymous performance data is also sent.
|
|
|
|
|
2021-04-22 20:31:24 +00:00
|
|
|
- `AUTHENTIK_ERROR_REPORTING__ENVIRONMENT`
|
2021-03-12 15:43:31 +00:00
|
|
|
|
|
|
|
Unique environment that is attached to your error reports, should be set to your email address for example. Defaults to `customer`.
|
|
|
|
|
2021-04-22 20:31:24 +00:00
|
|
|
- `AUTHENTIK_ERROR_REPORTING__SEND_PII`
|
2021-03-12 15:43:31 +00:00
|
|
|
|
|
|
|
Whether or not to send personal data, like usernames. Defaults to `false`.
|
|
|
|
|
2021-05-08 15:14:14 +00:00
|
|
|
### AUTHENTIK_EMAIL
|
2021-03-12 15:43:31 +00:00
|
|
|
|
2021-04-22 20:31:24 +00:00
|
|
|
- `AUTHENTIK_EMAIL__HOST`
|
2021-03-12 15:43:31 +00:00
|
|
|
|
|
|
|
Default: `localhost`
|
|
|
|
|
2021-04-22 20:31:24 +00:00
|
|
|
- `AUTHENTIK_EMAIL__PORT`
|
2021-03-12 15:43:31 +00:00
|
|
|
|
|
|
|
Default: `25`
|
|
|
|
|
2021-04-22 20:31:24 +00:00
|
|
|
- `AUTHENTIK_EMAIL__USERNAME`
|
2021-03-12 15:43:31 +00:00
|
|
|
|
|
|
|
Default: `""`
|
|
|
|
|
2021-04-22 20:31:24 +00:00
|
|
|
- `AUTHENTIK_EMAIL__PASSWORD`
|
2021-03-12 15:43:31 +00:00
|
|
|
|
|
|
|
Default: `""`
|
|
|
|
|
2021-04-22 20:31:24 +00:00
|
|
|
- `AUTHENTIK_EMAIL__USE_TLS`
|
2021-03-12 15:43:31 +00:00
|
|
|
|
|
|
|
Default: `false`
|
|
|
|
|
2021-04-22 20:31:24 +00:00
|
|
|
- `AUTHENTIK_EMAIL__USE_SSL`
|
2021-03-12 15:43:31 +00:00
|
|
|
|
|
|
|
Default: `false`
|
|
|
|
|
2021-04-22 20:31:24 +00:00
|
|
|
- `AUTHENTIK_EMAIL__TIMEOUT`
|
2021-03-12 15:43:31 +00:00
|
|
|
|
|
|
|
Default: `10`
|
|
|
|
|
2021-04-22 20:31:24 +00:00
|
|
|
- `AUTHENTIK_EMAIL__FROM`
|
2021-03-12 15:43:31 +00:00
|
|
|
|
|
|
|
Default: `authentik@localhost`
|
|
|
|
|
|
|
|
Email address authentik will send from, should have a correct @domain
|
|
|
|
|
2021-05-08 15:14:14 +00:00
|
|
|
### AUTHENTIK_OUTPOSTS
|
2021-03-12 15:43:31 +00:00
|
|
|
|
2021-04-22 20:31:24 +00:00
|
|
|
- `AUTHENTIK_OUTPOSTS__DOCKER_IMAGE_BASE`
|
2021-03-12 15:43:31 +00:00
|
|
|
|
2021-06-08 13:32:23 +00:00
|
|
|
Placeholders:
|
|
|
|
- `%(type)s`: Outpost type; proxy, ldap, etc
|
|
|
|
- `%(version)s`: Current version; 2021.4.1
|
|
|
|
- `%(build_hash)s`: Build hash if you're running a beta version
|
|
|
|
|
|
|
|
Placeholder for outpost docker images. Default: `ghcr.io/goauthentik/%(type)s:%(version)s`.
|
2021-03-12 15:43:31 +00:00
|
|
|
|
2021-05-08 15:14:14 +00:00
|
|
|
### AUTHENTIK_AUTHENTIK
|
2021-03-12 15:43:31 +00:00
|
|
|
|
2021-04-22 20:31:24 +00:00
|
|
|
- `AUTHENTIK_AUTHENTIK__AVATARS`
|
2021-03-12 15:43:31 +00:00
|
|
|
|
|
|
|
Controls which avatars are shown. Defaults to `gravatar`. Can be set to `none` to disable avatars.
|