{
  "manifest_version": "1",
  "slug": "authentik",
  "title": "Authentik",
  "headline": "Self-host Authentik",
  "description": "Self-host Authentik with Docker Compose on an exe.dev VM: public login pages, a private admin interface, OIDC sign-in for Grafana, a login proxy, and backups.",
  "category": "security",
  "tags": [
    "authentik",
    "single sign-on",
    "sso",
    "oidc",
    "saml",
    "ldap",
    "identity provider",
    "forward auth",
    "docker compose",
    "postgresql",
    "keycloak alternative"
  ],
  "url": "https://exe.dev/deploy/authentik",
  "markdown_url": "https://exe-staging.dev/deploy/authentik.md",
  "upstream": {
    "website": "https://goauthentik.io/",
    "source": "https://github.com/goauthentik/authentik",
    "docs": "https://docs.goauthentik.io/",
    "license": "MIT (open-source edition)"
  },
  "example_vm_name": "my-authentik",
  "time": "20 minutes",
  "stack": [
    {
      "name": "Authentik 2026.8",
      "detail": "The official server and worker images, from Authentik's own compose file",
      "port": 9000,
      "data": "~/authentik/data"
    },
    {
      "name": "PostgreSQL 16",
      "detail": "Authentik's database, in the same Compose stack",
      "data": "Docker volume authentik_database"
    },
    {
      "name": "nginx",
      "detail": "Port 8000 serves everything but the admin interface; port 8080 serves it all",
      "port": 8000
    },
    {
      "name": "Nightly backup",
      "detail": "A systemd timer; a database dump plus the settings and uploads, kept two weeks",
      "data": "~/authentik/backups"
    }
  ],
  "access": [
    {
      "url": "https://my-authentik.exe.xyz/",
      "who": "public",
      "what": "Login pages, the users' app dashboard, OIDC, SAML and outpost endpoints, once you open it"
    },
    {
      "url": "https://my-authentik.exe.xyz:8080/",
      "who": "private",
      "what": "The admin interface, behind exe.dev login; the only place administrators can sign in"
    }
  ],
  "delivers": [
    "Authentik on PostgreSQL, with its base URL set to the VM's address and no first-visitor setup page to race for.",
    "An akadmin password and API token generated on the VM, in a file only you can read.",
    "A public port that refuses the admin interface, and a rule that stops administrators signing in there at all.",
    "The admin interface on a private port behind exe.dev login.",
    "Nightly database backups, with one restored into a scratch database to check it.",
    "Everything starts again after a reboot."
  ],
  "deployable": true,
  "deploy": {
    "new_vm_url": "https://exe-staging.dev/new?prompt=Set%20up%20Authentik%20on%20this%20VM%20by%20following%20the%20exe.dev%20recipe%20at%20https%3A%2F%2Fexe-staging.dev%2Fdeploy%2Fauthentik.md%3Fvia%3Ddeploy%20from%20top%20to%20bottom.%0A%0AThe%20recipe%27s%20example%20VM%20name%20is%20my-authentik.%20This%20VM%27s%20name%20is%20the%20output%20of%20%60hostname%60%3A%20use%20it%20wherever%20the%20recipe%20writes%20my-authentik.%20Skip%20the%20step%20that%20creates%20the%20VM%3B%20you%20are%20on%20it.%0A%0AYou%20are%20done%20when%20all%20of%20these%20are%20true.%20Check%20each%20one%20yourself%3A%0A-%20Authentik%20on%20PostgreSQL%2C%20with%20its%20base%20URL%20set%20to%20the%20VM%27s%20address%20and%20no%20first-visitor%20setup%20page%20to%20race%20for.%0A-%20An%20akadmin%20password%20and%20API%20token%20generated%20on%20the%20VM%2C%20in%20a%20file%20only%20you%20can%20read.%0A-%20A%20public%20port%20that%20refuses%20the%20admin%20interface%2C%20and%20a%20rule%20that%20stops%20administrators%20signing%20in%20there%20at%20all.%0A-%20The%20admin%20interface%20on%20a%20private%20port%20behind%20exe.dev%20login.%0A-%20Nightly%20database%20backups%2C%20with%20one%20restored%20into%20a%20scratch%20database%20to%20check%20it.%0A-%20Everything%20starts%20again%20after%20a%20reboot.%0A%0ARead%20the%20whole%20recipe%2C%20including%20the%20closed%20details.%20For%20initial%20setup%2C%0Afollow%20%22Install%20by%20hand%22%20first%2C%20skipping%20VM%20creation%20and%20SSH%3A%20Docker%2C%0Athe%20settings%2C%20starting%20Authentik%2C%20nginx%2C%20the%20backup%20timer%2C%20and%20the%20backup%0Atest.%20The%20walkthrough%20at%20the%20top%20is%20for%20the%20owner%20afterwards.%0AWork%20as%20exedev%20in%20~%2Fauthentik.%20Never%20overwrite%20an%20existing%20.env.%20Don%27t%0Acreate%20users%2C%20groups%2C%20applications%20or%20outposts%2C%20set%20up%20SMTP%20or%20connect%0Aapps%20unless%20the%20owner%20asks.%20Don%27t%20run%20Restore%20or%20Update.%20You%20can%27t%20make%0Athe%20VM%20public%20from%20the%20VM%3B%20leave%20that%20to%20the%20owner%2C%20and%20don%27t%20ask%20them%20to%0Auntil%20you%27re%20done.%0AVerify%20docker.service%20and%20nginx%20are%20enabled%2C%20all%20three%20containers%20use%0Aunless-stopped%20and%20are%20healthy%2C%20.%2Fak%20GET%20admin%2Fversion%2F%20reports%0A2026.8.6%2C%20the%20exe.dev%20blueprint%27s%20status%20is%20successful%2C%20%2Fif%2Fadmin%2F%20on%0Alocalhost%3A8000%20redirects%20to%20port%208080%2C%20the%20login%20flow%20returns%20200%20on%0Alocalhost%3A8000%2C%20the%20admin%20interface%20returns%20200%20on%20localhost%3A8080%2C%20the%0Abackup%20timer%20is%20enabled%20and%20the%20backup%20test%20lists%20akadmin.%20Do%20not%20reboot.%0ANever%20paste%20a%20password%20or%20token%20into%20the%20chat%3B%20say%20the%20akadmin%20password%0Ais%20AUTHENTIK_BOOTSTRAP_PASSWORD%20in%20~%2Fauthentik%2F.env.%20Finish%20by%20pointing%0Athe%20owner%20to%20%22Open%20the%20admin%20interface%22%20and%20%22Open%20the%20login%20pages%22.%0A%0AFinish%20with%20the%20URLs%20I%20should%20open.%0A",
    "terminal": "curl -fsSL https://exe-staging.dev/deploy/authentik/prompt.txt | ssh exe.dev new --prompt=/dev/stdin",
    "prompt": "Set up Authentik on this VM by following the exe.dev recipe at https://exe-staging.dev/deploy/authentik.md?via=deploy from top to bottom.\n\nThe recipe's example VM name is my-authentik. This VM's name is the output of `hostname`: use it wherever the recipe writes my-authentik. Skip the step that creates the VM; you are on it.\n\nYou are done when all of these are true. Check each one yourself:\n- Authentik on PostgreSQL, with its base URL set to the VM's address and no first-visitor setup page to race for.\n- An akadmin password and API token generated on the VM, in a file only you can read.\n- A public port that refuses the admin interface, and a rule that stops administrators signing in there at all.\n- The admin interface on a private port behind exe.dev login.\n- Nightly database backups, with one restored into a scratch database to check it.\n- Everything starts again after a reboot.\n\nRead the whole recipe, including the closed details. For initial setup,\nfollow \"Install by hand\" first, skipping VM creation and SSH: Docker,\nthe settings, starting Authentik, nginx, the backup timer, and the backup\ntest. The walkthrough at the top is for the owner afterwards.\nWork as exedev in ~/authentik. Never overwrite an existing .env. Don't\ncreate users, groups, applications or outposts, set up SMTP or connect\napps unless the owner asks. Don't run Restore or Update. You can't make\nthe VM public from the VM; leave that to the owner, and don't ask them to\nuntil you're done.\nVerify docker.service and nginx are enabled, all three containers use\nunless-stopped and are healthy, ./ak GET admin/version/ reports\n2026.8.6, the exe.dev blueprint's status is successful, /if/admin/ on\nlocalhost:8000 redirects to port 8080, the login flow returns 200 on\nlocalhost:8000, the admin interface returns 200 on localhost:8080, the\nbackup timer is enabled and the backup test lists akadmin. Do not reboot.\nNever paste a password or token into the chat; say the akadmin password\nis AUTHENTIK_BOOTSTRAP_PASSWORD in ~/authentik/.env. Finish by pointing\nthe owner to \"Open the admin interface\" and \"Open the login pages\".\n\nFinish with the URLs I should open.\n",
    "prompt_url": "https://exe-staging.dev/deploy/authentik/prompt.txt"
  },
  "published": "2026-11-21",
  "updated": "2026-11-21",
  "verified": "2026-11-21",
  "related": [
    "keycloak",
    "grafana",
    "postgres",
    "vaultwarden",
    "docker-compose",
    "agent-secrets"
  ],
  "alternatives": [
    "Auth0",
    "Okta",
    "Keycloak"
  ],
  "files": [
    "https://exe-staging.dev/deploy/authentik/admins-private.yaml",
    "https://exe-staging.dev/deploy/authentik/ak",
    "https://exe-staging.dev/deploy/authentik/backup.sh",
    "https://exe-staging.dev/deploy/authentik/compose.yaml",
    "https://exe-staging.dev/deploy/authentik/nginx.conf"
  ]
}
