SSD Nodes Learn Hosting plans →
Mga Gabay Matt ConnorNi Matt Connor

Authéntik self-hosted SSO para sa lahat ng app

I-run ang Authentik sa Docker Compose para sa isang login: alamin ang mahahalagang env value, akadmin bootstrap, at Traefik forward auth.

Isang login para sa bawat app na iyong hina-host

Ang Authentik ay isang self-hosted SSO (single sign-on) server: mag-sa-sign in ang iyong mga user nang isang beses, at tatanggapin ng bawat app sa likod nito ang session na iyon sa halip na humingi ng sariling password. Ang install ay binubuo ng isang opisyal na Docker Compose file at dalawang generated secret. Ang bahaging nangangailangan ng masusing pag-iisip ay ang kasunod nito: ang pagtutok ng reverse proxy dito, at ang paglalagay ng isang existing app sa likod ng forward auth.

Ang Authentik ay may tatlong serbisyo sa Compose file na iyon: isang PostgreSQL database, isang server process, at isang worker process. Ang server container ay nagpapatakbo rin ng embedded outpost, ang component na sumasagot ng "naka-sign in ba ang request na ito?" para sa bawat protected app. Ang version 2026.8.5 ang kasalukuyang release simula noong 25 October 2026. Inilabas ito noong 21 October 2026 bilang pinakabagong patch ng 2026.8 series, na nagsimula sa 2026.8.0 noong 18 August, at pinalitan nito ang 2026.8.4 mula noong 14 October bilang default image tag sa opisyal na Compose file. Nangangailangan ang project ng host na may hindi bababa sa 2 CPU core at 2 GB ng RAM. Ituring ito bilang minimum. Ang PostgreSQL at ang worker ay parehong kumakain ng memory kapag tumatakbo na ang server nang isang araw.

Ano ang kailangan bago magsimula

Kailangan mo ng Docker Engine na may Compose v2 plugin. Makukumpirma mo ito gamit ang docker compose version. Kung error ang lumabas sa halip na version, i-install muna ang plugin bago magpatuloy. Tinalakay ang mga pangunahing hakbang sa pagpapatakbo ng mga app gamit ang Docker Compose sa isang VPS. Kailangan mo rin ng DNS A record na nakaturo sa server, gaya ng auth.example.com sa mga halimbawa sa ibaba, dahil binubuo ng Authentik ang redirect URLs nito batay sa hostname na ginamit ng browser.

Patakbuhin ang stack bilang ordinaryong user na kabilang sa docker group, hindi bilang root. Ang pagiging miyembro ng group na iyon ay katumbas ng root access sa host. Kaya ibigay ito sa isang deploy account lamang at huwag sa iba, alinsunod sa mga user account na may least privilege sa isang VPS.

Pag-install gamit ang opisyal na Compose file

sudo install -d -o "$USER" -g "$USER" /opt/authentik
cd /opt/authentik
wget https://docs.goauthentik.io/compose.yml
echo "PG_PASS=$(openssl rand -base64 36 | tr -d '\n')" >> .env
echo "AUTHENTIK_SECRET_KEY=$(openssl rand -base64 60 | tr -d '\n')" >> .env
docker compose pull
docker compose up -d

Dapat ipakita ng docker compose ps ang tatlong container na pare-parehong up, kung saan ang postgresql ay nag-uulat ng healthy kapag pumasa na ang check nito. Ang unang start ay nagpapatakbo ng database migration, kaya bigyan ito ng isang minuto bago sumagot ang web interface.

Mahalaga ang dalawang generated value dahil sa magkaibang dahilan. Ang PG_PASS ay ang password ng PostgreSQL. Ayon sa install docs ng Authentik, hindi suportado ang mga password na lampas sa 99 na character, kaya panatilihin ang anumang password na pipiliin mo sa ilalim ng limitasyong iyon; mas maikli ang generated password. Ang AUTHENTIK_SECRET_KEY ay ang key na ginagamit ng Authentik para pirmahan ang mga cookie, at ayon sa configuration docs nito, ang pagpapalit dito ay magpapawalang-bisa sa mga active session, kaya ang bagong key ay mag-sa-sign out sa lahat ng naka-sign in na user. Panatilihin ang .env sa mode 600 at magtago ng kopya sa ligtas na lugar kasama ng iyong mga backup, para sa oras ng restore ay gamit pa rin nito ang parehong key na ginamit noon.

Minarkahan ng Compose file ang parehong value bilang required gamit ang ${VAR:?message} form: ${PG_PASS:?database password required} sa PostgreSQL service at ${AUTHENTIK_SECRET_KEY:?secret key required} sa server at worker. Ibig sabihin, tatanggi ang Compose na mag-start kapag kulang ang file. Ang pagtakbo ng docker compose up -d mula sa maling directory ay magpi-print ng linya gaya ng required variable AUTHENTIK_SECRET_KEY is missing a value: secret key required at hihinto. Ang mensaheng iyon ay problema sa path, hindi sa config.

Mga environment value na mahalaga

Lahat ng iba pa ay ilalagay sa parehong .env file. Minamapa ng Authentik ang double underscore bilang nested configuration key, kaya itinatakda ng AUTHENTIK_EMAIL__HOST ang email.host. Hindi minamapa ng single underscore ang nested key. Ito ang pinakakaraniwang dahilan kung bakit mukhang walang epekto ang isang setting.

  • Itinatakda ng AUTHENTIK_BOOTSTRAP_PASSWORD ang password ng built-in na akadmin user sa unang pagsisimula, kaya hindi mo kailangang mag-type ng password sa isang public web form. Itinatakda rin ng AUTHENTIK_BOOTSTRAP_EMAIL at AUTHENTIK_BOOTSTRAP_TOKEN ang address ng user na iyon at isang API token.
  • Inililipat ng COMPOSE_PORT_HTTP at COMPOSE_PORT_HTTPS ang published ports mula sa default na 9000 at 9443.
  • Kino-configure ng AUTHENTIK_EMAIL__HOST, AUTHENTIK_EMAIL__PORT, AUTHENTIK_EMAIL__USERNAME, AUTHENTIK_EMAIL__PASSWORD, AUTHENTIK_EMAIL__USE_TLS at AUTHENTIK_EMAIL__FROM ang outbound mail. Kung wala ang mga ito, sinusubukan ng Authentik ang localhost sa port 25, kaya nagtatapos sa connection error ang mga password-reset mail sa worker log.
  • Ino-on ng AUTHENTIK_LOG_LEVEL=debug ang detalye na kailangan mo habang may problema sa login flow. Ibalik ito sa info pagkatapos.
  • Ang default ng AUTHENTIK_ERROR_REPORTING__ENABLED ay false. Itakda lamang ito sa true kung ayos sa iyo na magpadala ng crash report sa upstream.

Mga secret ang mga ito sa isang plain file, kaya pangasiwaan ang directory na parang iba pang credential store. Mas mainam na ilagay ang backup para sa recovery sa isang self-hosted na Vaultwarden instance kaysa sa isang note sa iyong laptop.

Unang login at ang admin account

Buksan ang http://SERVER_IP:9000 sa isang browser. Ipapakita ng Authentik ang initial setup flow nito at hihilingin sa iyong magtakda ng password para sa default na akadmin user. Kung naitakda mo na ang AUTHENTIK_BOOTSTRAP_PASSWORD, tapos na ang step na iyon at diretso ka na sa login page.

Gumawa ng normal na admin user para sa iyong sarili sa ilalim ng Directory at pagkatapos ay Users, idagdag ito sa authentik Admins group, at mag-sign in gamit ang account na iyon. Iwanan ang akadmin bilang break-glass account na may mahabang password na nakatago offline. Kung sakaling ma-lock out ka dahil sa sirang flow o stage, ang docker compose run --rm server create_recovery_key 10 akadmin, na pinapatakbo mula sa /opt/authentik, ay magpi-print ng link na mag-sa-sign in sa iyo bilang akadmin nang direkta. Ang sinumang may hawak ng link na iyon ay may parehong access, kaya ituring ito na parang password. Ang pang-araw-araw na trabaho gamit ang isang shared built-in account ay sumisira sa audit log, dahil ang bawat event ay magsasabing akadmin at walang magsasabi kung sino ang gumawa. Ang argumentong iyon ay totoo rin sa downstream ng Authentik: ang isang bagay gaya ng isang self-hosted OneCLI harness na nagbibigay sa bawat tao ng sariling agent ay mag-iiwan lamang ng nababasang trail kung ang identity na dumarating dito ay pagmamay-ari ng isang tao sa halip na login na pinagsasaluhan ng buong team.

Ilagay ang Authentik sa likod ng reverse proxy

Gumagana ang pag-publish ng port 9000 sa internet, pero kailangan mo ng TLS (transport layer security) at totoong hostname. Kung ginagamit mo na ang setup mula sa Traefik bilang reverse proxy para sa maraming Compose app, isama ang Authentik sa parehong external proxy network gamit ang override file. Gawin ang docker-compose.override.yml sa tabi ng compose.yml:

services:
  server:
    networks:
      - default
      - proxy
    labels:
      traefik.enable: "true"
      traefik.docker.network: proxy
      traefik.http.routers.authentik.rule: Host(`auth.example.com`)
      traefik.http.routers.authentik.entrypoints: websecure
      traefik.http.routers.authentik.tls.certresolver: le
      traefik.http.services.authentik.loadbalancer.server.port: "9000"

networks:
  proxy:
    external: true

Ilapat ito gamit ang docker compose up -d. Awtomatikong pinagsasama ng Compose ang override, kaya nananatili sa server service ang lahat ng nasa opisyal na file at nadaragdagan ito ng mga label. Suriin gamit ang curl -I https://auth.example.com/if/user/, na dapat sumagot sa HTTP/2 200. Ang 404 page not found mula sa Traefik ay nangangahulugang walang router na tumugma sa request. Tiyaking nakarating ang mga label sa container, eksaktong tumutugma ang Host() rule sa hostname, at dumating ang request sa HTTPS entry point na pinakikinggan ng router.

Kapag gumagana na ang hostname, i-bind ang mga published port sa 127.0.0.1 sa override, para sa proxy lamang dumaan ang access.

Protektahan ang isang app gamit ang forward auth

May tatlong mode ang proxy provider ng Authentik, at maaaring umabot ng isang oras ang mawawala kapag mali ang napili. Ang Proxy ay nangangahulugang ang outpost mismo ang nagpapasa ng traffic sa upstream app. Ang Forward auth (single application) ay nangangahulugang ang sarili mong reverse proxy pa rin ang nagpapasa ng traffic, at tinatanong lamang nito ang Authentik kung naka-sign in ang request. Pinoprotektahan ng Forward auth (domain level) ang bawat app sa ilalim ng iisang parent domain gamit ang isang provider, kapalit ng pagkawala ng per-application authorization rules. Kapag Traefik ang nasa unahan, dapat mong gamitin ang forward auth (single application). Kung gusto mo ng konkretong app na pagpraktisan, magandang unang kandidato ang isang self-hosted na AFFiNE workspace, dahil uri ito ng internal tool na dapat ma-access mula sa sarili mong mga device at wala nang iba. Mas malinaw pa ang ganitong gamit para sa isang team tool: ilagay ang isang self-hosted na Chatwoot support desk sa likod ng parehong provider upang isang beses lang mag-sign in sa buong araw ang bawat sumasagot sa inbox, sa halip na magbahagi pa ng isa pang password.

Sa web interface, buksan ang Applications at pagkatapos ay Providers, gumawa ng Proxy Provider, piliin ang forward auth single application mode, at itakda ang external host sa https://app.example.com. Gumawa ng Application na tumutukoy sa provider na iyon. Pagkatapos, buksan ang Outposts, i-edit ang authentik Embedded Outpost, at ilipat ang bagong application sa selected applications nito. Sumasagot lamang ang outpost para sa mga application na ibinigay sa kanila, kaya kapag nilaktawan ang huling hakbang na iyon, walang ibinabalik ang provider kahit tama ang configuration.

I-define nang isang beses ang middleware sa Authentik container, at i-reference ito mula sa bawat protected app:

      traefik.http.middlewares.authentik.forwardauth.address: http://server:9000/outpost.goauthentik.io/auth/traefik
      traefik.http.middlewares.authentik.forwardauth.trustForwardHeader: "true"
      traefik.http.middlewares.authentik.forwardauth.authResponseHeaders: X-authentik-username,X-authentik-groups,X-authentik-entitlements,X-authentik-email,X-authentik-name,X-authentik-uid,X-authentik-jwt,X-authentik-meta-jwks,X-authentik-meta-outpost,X-authentik-meta-provider,X-authentik-meta-app,X-authentik-meta-version

Ang authResponseHeaders ang listahan ng mga header na kinokopya ng Traefik mula sa sagot ng Authentik papunta sa request na ipinapadala nito upstream. Kapag inalis ito, protected pa rin ang app, pero hindi nito nalalaman kung sino ang user. Dahil dito, mananatiling naka-logout ang anumang bumabasa sa X-authentik-username para sa automatic login. Pinakamalinaw ang puwang na ito kapag nasa harap ng app na may sarili nitong sign-in, gaya ng isang self-hosted na openGym workout tracker at passkey login nito, kung saan ang mga header ang nagiging pagkakaiba sa pagitan ng isang prompt at dalawang prompt para sa parehong page.

Ang protected app mismo ay nangangailangan ng dalawang router, hindi isa:

    labels:
      traefik.enable: "true"
      traefik.http.routers.myapp.rule: Host(`app.example.com`)
      traefik.http.routers.myapp.entrypoints: websecure
      traefik.http.routers.myapp.tls.certresolver: le
      traefik.http.routers.myapp.middlewares: authentik@docker
      traefik.http.routers.myapp-auth.rule: Host(`app.example.com`) && PathPrefix(`/outpost.goauthentik.io/`)
      traefik.http.routers.myapp-auth.entrypoints: websecure
      traefik.http.routers.myapp-auth.tls.certresolver: le
      traefik.http.routers.myapp-auth.priority: "15"
      traefik.http.routers.myapp-auth.service: authentik

Ang pangalawang router ang bahaging madalas nakakaligtaan ng lahat. Pagkatapos ng sign-in, ibinabalik ng Authentik ang browser sa isang path sa ilalim ng /outpost.goauthentik.io/ sa hostname ng app, hindi sa auth.example.com. Kung walang router na nagpapasa ng path prefix na iyon sa Authentik service, mapupunta ang request sa app mo, magbabalik ito ng 404, at hindi matatapos ang login. Ang mas mataas na priority ang nagtitiyak na mananaig ang partikular na path rule kaysa sa plain na Host() rule sa parehong domain.

Subukan ito sa isang private browser window. Dapat kang ipadala sa auth.example.com, mag-sign in, at bumalik sa app. Ang docker compose logs -f server sa panig ng Authentik ay nagpi-print ng authorization event sa bawat pagtatangka. Ipinapakita nito kung nakarating ba talaga ang request sa Authentik.

Mga failure na aktuwal mong mararanasan

Walang katapusang redirect loop sa pagitan ng app at login page. Hindi tugma ang external host sa provider at ang ginagamit ng browser; karaniwan, http:// ang nasa provider samantalang https:// ang nasa address bar. Itinatakda ang session cookie para sa ibang origin, kaya ang bawat balik ay itinuturing na bagong anonymous request. Ayusin ang external host at i-clear ang cookies para sa parehong domain bago muling mag-test.

404 sa /outpost.goauthentik.io/start. Nawawala ang outpost router, o mas mababa ang priority nito kaysa sa catch-all router para sa host na iyon.

Naglo-load ang app nang hindi kailanman humihingi ng login. Ang label na middlewares ay tumutukoy sa middleware na hindi umiiral. Hindi naglalabas ng warning ang Traefik tungkol dito, kaya ang typo sa authentik@docker ay nangangahulugang walang middleware na tumatakbo. Buksan ang Traefik dashboard at tiyaking nakalista ang middleware sa router.

403 mula sa Authentik matapos ang matagumpay na login. Authenticated ang user pero hindi authorized: may policy binding o group requirement ang application na hindi natutugunan ng user na ito. Tinutukoy sa Events log ng admin interface ang policy na tumanggi sa request.

Kapag mas angkop ang Keycloak

Mas matagal nang proyekto ang Keycloak, sinusuportahan ng Red Hat, at mas mahusay itong pagpipilian para sa classic enterprise identity work: malawakang SAML federation, pag-broker ng mga login mula sa ilang external identity provider nang sabay-sabay, at paggamit ng realm export at import bilang dokumentadong migration path. Mahalaga rin sa ilang organisasyon ang commercial support nito. Ang kapalit ay walang sariling proxy ang Keycloak. Kaya para maprotektahan ang app na hindi gumagamit ng OIDC (OpenID Connect) o SAML, kailangan mong magpatakbo ng gaya ng oauth2-proxy kasabay nito. Ang built-in proxy provider ng Authentik ang nagbibigay ng bahaging ito at naka-integrate na rito. Dahil dito, dito karaniwang napupunta ang karamihan ng self-hosters na may halo-halong app.

Mga backup at upgrade

Tatlong bagay ang nagpapaposible sa restore: ang PostgreSQL database, ang ./data directory, at .env.

cd /opt/authentik
docker compose exec -T postgresql pg_dump -U authentik authentik | gzip > authentik-$(date +%F).sql.gz

Itago ang dump na iyon at ang .env nang magkasama. Ang dump ay walang kopya ng AUTHENTIK_SECRET_KEY, at ang pag-restore gamit ang ibang key ay magpapawalang-bisa sa bawat active session, kaya ang pagpapanatili sa orihinal na key ay nangangahulugang magpapatuloy ang restored server gaya ng dati.

Ang mga upgrade ay pagpapalit ng tag. Itakda ang AUTHENTIK_TAG sa .env sa release na gusto mo, pagkatapos ay patakbuhin ang docker compose pull na susundan ng docker compose up -d. Kung hindi mo kailanman itinakda ang AUTHENTIK_TAG, ang version ay magmumula sa default na nakasulat sa compose.yml mismo, kaya ang pag-download ng mas bagong kopya ng file na iyon ang siyang upgrade, at iyon ang rutang inilalarawan ng opisyal na upgrade docs. Basahin muna ang release notes. Gumagamit ang Authentik ng date-based na version, at simula noong October 2026, ayon sa docs nito, ang mga upgrade ay dapat sumunod sa pagkakasunod-sunod ng mga major release: lumipat sa pinakabagong patch ng series na ginagamit mo, pagkatapos ay isa-isang dumaan sa bawat susunod na series nang hindi lumalaktaw. Hindi suportado ng Authentik ang downgrading, kaya kumuha ng database dump bago ang pull, hindi pagkatapos.

FAQ

Libre bang i-self-host ang Authentik?

Libre ang open source edition at saklaw nito ang lahat ng nabanggit sa itaas: proxy provider, forward auth, OIDC (OpenID Connect), SAML, at flows engine. May support at ilang enterprise feature ang bayad na enterprise tier, pero walang bahagi rito ang nangangailangan ng license.

Kailangan ba ang Traefik para magamit ang Authentik?

Hindi. Gumagana ang forward auth sa nginx sa pamamagitan ng auth_request at sa Caddy sa pamamagitan ng forward_auth. Pareho ang pattern sa lahat ng kaso: nagtatanong ang reverse proxy sa Authentik tungkol sa bawat request, at dapat i-route sa Authentik ang path prefix na /outpost.goauthentik.io/ sa protected hostname sa halip na sa app.

Bakit paulit-ulit na bumabalik ang protected app sa login at error?

Hindi tugma ang external host na naka-configure sa proxy provider sa URL na ginagamit ng browser, kadalasan ay http laban sa https. Ibinibigay ang session cookie para sa isang origin pero binabasa ito sa ibang origin, kaya bawat request ay nakikita ng Authentik na anonymous. Itama ang external host, pagkatapos ay i-clear ang cookies para sa parehong hostname bago muling mag-test.

Gaano karaming RAM ang kailangan ng Authentik?

Ang nakadokumentong minimum ay 2 CPU cores at 2 GB ng RAM noong October 2026, para sa PostgreSQL, server, at worker nang magkakasama. Sa isang 2 GB na machine, maaaring ma-trigger ng memory pressure ang OOM killer ng kernel. Tinatapos nito ang process na may pinakamataas na badness score: tinatayang bahagi ng allowed memory na ginagamit nito, kasama ang oom_score_adj. Kapag worker ang natatapos, ang sintomas ay humihinto ang background tasks at outbound email habang gumagana pa rin ang login page. Maglaan ng 4 GB kung pinapatakbo rin sa parehong server ang mga app na pinoprotektahan mo.

Nakatulong ba ang artikulong ito?