Remove Authentik
This page shows you how to remove Authentik from your server. First you move your apps to another login method. Then you delete Authentik in the Stack Manager.
Before you start
Section titled “Before you start”- Authentik is installed with Deployrr.
- Decide which login method your apps will use instead: Authelia, Google OAuth, TinyAuth, Basic HTTP Auth or No Authentication. If you pick Authelia, Google OAuth or TinyAuth, set it up from the Security menu first and make sure it is running. Choose a login method compares them.
- Decide if you want to keep Authentik’s data. A Full delete removes its users, settings and database. A Safe delete keeps them, so you can reinstall later and reuse them. See Reinstall an app and keep its data.
- Deleting with the Stack Manager needs a Basic, Plus or Pro license.
In v6, Authentik runs as three containers, each with its own file in compose/HOSTNAME/ in your Docker folder:
authentik(the main app)authentik-workerauthentik-postgresql
You delete all three in one go. You can’t delete authentik-worker or authentik-postgresql on their own. If you try, Deployrr says Cannot delete dependency directly and tells you to delete authentik instead.
Switch your apps to another login method
Section titled “Switch your apps to another login method”There are two ways. Manage Auth does it for you. It needs a Pro license, Setup Mode set to Hybrid, and Traefik running. Without those, edit the files yourself.
With Manage Auth (Pro)
Section titled “With Manage Auth (Pro)”- From the main menu, select Security.
- Select Manage Auth.
- Read the Requirements to Manage Authentication warning, then select Yes to continue. Yes is the button on the right. If you press Enter straight away, you select No and go back.
- In the list, look for apps shown with Authentik. App names are in capitals, with their current login method next to them.
- Select one of those apps.
- At
Select new authentication method, pick the new method. Don’t pick Authentik. It is listed while it is still running. - Repeat steps 5 and 6 for each app that shows Authentik.
For apps set up with a Traefik rules file, the change applies right away. For apps set up with Docker labels, Deployrr recreates the container for you.
By editing the files (any license)
Section titled “By editing the files (any license)”Each app uses a login chain. Apps that use Authentik have chain-authentik in their settings. Change it to one of these:
| Chain | Login method | Available |
|---|---|---|
chain-no-auth |
No Authentication | Always |
chain-basic-auth |
Basic HTTP Auth | Always |
chain-authelia |
Authelia | After you set up Authelia |
chain-tinyauth |
TinyAuth | After you set up TinyAuth |
chain-oauth |
Google OAuth | After you set up Google OAuth |
Only use a chain for a method you have set up. Otherwise the app stops loading.
Apps with a rules file:
-
Open the app’s file in
appdata/traefik3/rules/HOSTNAME/inside your Docker folder, for example:Terminal window sudo nano appdata/traefik3/rules/HOSTNAME/app-sonarr.yml -
Under
middlewares:, change- chain-authentikto the chain you picked, for example- chain-authelia. -
Save the file. Traefik picks up the change on its own.
Apps with Docker labels:
- Open the app’s compose file, for example
compose/HOSTNAME/sonarr.yml. - Find the label that ends in
.middlewares=chain-authentik@file. - Change
chain-authentikto the chain you picked. Keep@fileat the end. - Save the file, then recreate the app with Tools > Stack Manager > Recreate.
Do this for every app that uses chain-authentik. Don’t change Authentik’s own compose file.
Delete Authentik
Section titled “Delete Authentik”- From the main menu, select Tools.
- Select Stack Manager.
- Select Delete.
- Choose how to delete:
- Safe keeps the app’s data: the
appdata/authentikandappdata/authentik-postgresqlfolders and the secret files. - Full removes everything, including the app’s data.
- Safe keeps the app’s data: the
- When Deployrr asks about a live backup, press
Yto make one. Press any other key to skip it. A cold backup from Tools > Backups is the safer choice (see Back up and restore your Docker folder). - At
Enter the number of the service to delete:, type the number next toauthentik. - In the Multicontainer App Deletion window, select Delete authentik + all dependencies.
- Press
Yto confirm. - Wait for
authentik + dependencies deleted successfully.
If you pick Delete authentik only, the worker and the database stay behind. Choose the option with all dependencies to remove everything.
What gets removed
Section titled “What gets removed”Both Safe and Full remove:
- The three Authentik containers.
- The Authentik
include:lines in your main compose file, and the Authentik files incompose/HOSTNAME/. - Authentik’s entries in the
.envfile, such as its version pin, database password and secret key entries. - The secret entries for Authentik in your main compose file.
- Authentik’s tile on the Deployrr Dashboard, if you use it.
Full also removes:
- Authentik’s secret files (the database password and the secret key).
- The
appdata/authentikandappdata/authentik-postgresqlfolders. - Docker volumes that are no longer used.
The Authentik rule files in appdata/traefik3/rules/HOSTNAME/ (chain-authentik.yml and middlewares-authentik.yml) stay in place. They do no harm.
Check it worked
Section titled “Check it worked”-
Run this command:
Terminal window sudo docker ps -a --filter name=authentikWith the Deployrr bash aliases:
dps. It lists all containers, so check that no name starts withauthentik.The list should be empty.
-
Open one of the apps you switched. It should ask for the new login, or load straight away if you chose No Authentication.
-
If an app shows an error, check that its chain matches a login method you have set up. Read the Traefik logs to see which middleware Traefik can’t find.

