docker-compose installation
This installation method is for test-setups and small-scale productive setups.
#
Requirements- A Linux host with at least 2 CPU cores and 4 GB of RAM.
- docker
- docker-compose
#
PreparationDownload the latest docker-compose.yml
from here. Place it in a directory of your choice.
To optionally enable error-reporting, run echo AUTHENTIK_ERROR_REPORTING__ENABLED=true >> .env
To optionally deploy a different version run echo AUTHENTIK_TAG=2021.3.4 >> .env
If this is a fresh authentik install run the following commands to generate a password:
#
Email configuration (optional, but recommended)It is also recommended to configure global email credentials. These are used by authentik to notify you about alerts, configuration issues. They can also be used by Email stages to send verification/recovery emails.
Append this block to your .env
file
#
GeoIP configuration (optional)authentik can use a MaxMind-formatted GeoIP Database to extract location data from IPs. You can then use this location data in policies, and location data is saved in events.
To configure GeoIP, sign up for a free MaxMind account here.
After you have your account ID and license key, add the following block to your .env
file:
The GeoIP database will automatically be updated every 8 hours.
#
StartupAfterwards, run these commands to finish
The compose file statically references the latest version available at the time of downloading, which can be overridden with the SERVER_TAG
environment variable.
authentik will then be reachable HTTPS on port 443. You can optionally configure the packaged traefik to use Let's Encrypt certificates for TLS Encryption.
The initial setup process also creates a default admin user, the username and password for which is akadmin
. It is highly recommended to change this password as soon as you log in.