SSD Nodes Learn Hosting plans →

Authentik SSO సెటప్ చేయడం ఎలా: Docker Compose గైడ్

Docker Compose ద్వారా Authentik SSOని ఇన్‌స్టాల్ చేయండి. PostgreSQL, వర్కర్ కాన్ఫిగరేషన్, akadmin బూట్‌స్ట్రాప్ మరియు Traefik ఫార్వర్డ్ ఆథ్ సెటప్ కోసం ఈ పూర్తి గైడ్ చూడండి.

మీరు హోస్ట్ చేసే ప్రతి అప్లికేషన్‌కు ఒకే లాగిన్

Authentik అనేది self-hosted SSO (single sign-on) సర్వర్: మీ వినియోగదారులు ఒకసారి లాగిన్ అయితే చాలు, ఆ తర్వాత ప్రతి అప్లికేషన్ ఆ సెషన్‌ను అంగీకరిస్తుంది, మళ్ళీ పాస్‌వర్డ్ అడగదు. దీని ఇన్‌స్టాలేషన్ అధికారిక Docker Compose ఫైల్ మరియు రెండు జనరేట్ చేసిన సీక్రెట్స్ ద్వారా జరుగుతుంది. దీని తర్వాత చేయాల్సిన అసలు పని: దీనికి reverse proxy ని అనుసంధానించడం మరియు ఇప్పటికే ఉన్న ఒక అప్లికేషన్‌ను forward auth వెనుక ఉంచడం.

Authentik ఆ Compose ఫైల్‌లో మూడు సర్వీసులుగా పనిచేస్తుంది: ఒక PostgreSQL డేటాబేస్, ఒక server ప్రాసెస్, మరియు ఒక worker ప్రాసెస్. సర్వర్ కంటైనర్ ఎంబెడెడ్ అవుట్‌పోస్ట్‌ను కూడా రన్ చేస్తుంది, ఇది ప్రతి ప్రొటెక్టెడ్ అప్లికేషన్ కోసం "ఈ అభ్యర్థన లాగిన్ అయి ఉందా?" అని సమాధానం ఇచ్చే భాగం. 25 అక్టోబర్ 2026 నాటికి 2026.8.5 వెర్షన్ ప్రస్తుత రిలీజ్. ఇది 21 అక్టోబర్ 2026న 2026.8 సిరీస్‌లో లేటెస్ట్ ప్యాచ్‌గా విడుదలయింది. ఈ సిరీస్ 18 ఆగస్టున 2026.8.0తో మొదలైంది. ఇది 14 అక్టోబర్ నాటి 2026.8.4 స్థానంలో అధికారిక Compose ఫైల్‌లో డిఫాల్ట్ ఇమేజ్ ట్యాగ్‌గా మారింది. ఈ ప్రాజెక్ట్ కోసం కనీసం 2 CPU కోర్లు మరియు 2 GB RAM ఉన్న హోస్ట్ అవసరం. దీన్నే కనీస అవసరంగా పరిగణించండి. సర్వర్ ఒక రోజు రన్ అయిన తర్వాత PostgreSQL మరియు వర్కర్ రెండూ మెమరీని ఆక్రమిస్తాయి.

ప్రారంభించడానికి ముందు మీకు కావలసినవి

మీకు Docker Engine తో పాటు Compose v2 ప్లగిన్ అవసరం. దీనిని మీరు docker compose version ద్వారా నిర్ధారించుకోవచ్చు. ఒకవేళ ఇది వెర్షన్ నంబర్‌కు బదులుగా ఎర్రర్‌ను చూపిస్తే, ముందుకు వెళ్లే ముందు ప్లగిన్‌ను ఇన్‌స్టాల్ చేయండి; దీనికి సంబంధించిన ప్రాథమిక అంశాలు VPS పై Docker Compose తో అప్లికేషన్లను రన్ చేయడం లో ఉన్నాయి. అలాగే సర్వర్‌ను సూచించే ఒక DNS A రికార్డు కూడా మీకు అవసరం. కింద ఉన్న ఉదాహరణలలో దీనిని auth.example.com గా పేర్కొన్నాము, ఎందుకంటే బ్రౌజర్ ఉపయోగించిన హోస్ట్‌నేమ్ ఆధారంగానే Authentik తన redirect URLలను రూపొందిస్తుంది.

ఈ స్టాక్‌ను root యూజర్‌గా కాకుండా, docker గ్రూపులో ఉన్న సాధారణ యూజర్‌గా రన్ చేయండి. ఈ గ్రూపులో సభ్యత్వం ఉండటం అంటే హోస్ట్ మెషీన్‌పై root అధికారాలు కలిగి ఉండటంతో సమానం. కాబట్టి, VPS పై కనీస అధికారాలు కలిగిన యూజర్ ఖాతాలు లో వివరించిన విధంగా, ఈ అధికారాలను కేవలం ఒక డిప్లాయ్ అకౌంట్‌కు మాత్రమే ఇవ్వండి.

అధికారిక Compose ఫైల్‌తో ఇన్‌స్టాలేషన్

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

docker compose ps మూడు కంటైనర్లు రన్ అవుతున్నట్లు చూపాలి, మరియు postgresql దాని చెక్ పూర్తయిన తర్వాత healthy అని రిపోర్ట్ చేయాలి. మొదటిసారి స్టార్ట్ చేసినప్పుడు డేటాబేస్ మైగ్రేషన్లు జరుగుతాయి, కాబట్టి వెబ్ ఇంటర్‌ఫేస్ స్పందించడానికి ఒక నిమిషం సమయం ఇవ్వండి.

జనరేట్ చేసిన రెండు విలువలు వేర్వేరు కారణాల వల్ల ముఖ్యమైనవి. PG_PASS అనేది PostgreSQL పాస్‌వర్డ్. Authentik ఇన్‌స్టాలేషన్ డాక్యుమెంట్స్ ప్రకారం 99 క్యారెక్టర్ల కంటే ఎక్కువ పొడవున్న పాస్‌వర్డ్‌లకు మద్దతు లేదు, కాబట్టి మీరు ఎంచుకునే పాస్‌వర్డ్ అంతకంటే తక్కువ ఉండేలా చూసుకోండి; జనరేట్ అయిన పాస్‌వర్డ్ చాలా చిన్నదిగా ఉంటుంది. AUTHENTIK_SECRET_KEY అనేది కుకీలను సైన్ చేయడానికి Authentik ఉపయోగించే కీ. దీని కాన్ఫిగరేషన్ డాక్యుమెంట్స్ ప్రకారం దీన్ని మార్చడం వల్ల యాక్టివ్ సెషన్లు రద్దవుతాయి, కాబట్టి కొత్త కీని మార్చినప్పుడు లాగిన్ అయి ఉన్న వినియోగదారులందరూ లాగ్ అవుట్ అవుతారు. .env ను 600 మోడ్‌లో ఉంచండి మరియు మీ బ్యాకప్‌లతో పాటు సురక్షితమైన చోట ఒక కాపీని దాచుకోండి, తద్వారా సర్వర్ రీస్టోర్ చేసినప్పుడు అదే కీతో తిరిగి వస్తుంది.

Compose ఫైల్ ఈ రెండు విలువలను ${VAR:?message} ఫార్మాట్ ద్వారా అవసరమైనవిగా గుర్తిస్తుంది: PostgreSQL సర్వీస్‌పై ${PG_PASS:?database password required} మరియు సర్వర్, వర్కర్లపై ${AUTHENTIK_SECRET_KEY:?secret key required}. అంటే ఫైల్ లేకపోతే Compose స్టార్ట్ అవ్వదు. తప్పు డైరెక్టరీ నుండి docker compose up -d రన్ చేస్తే required variable AUTHENTIK_SECRET_KEY is missing a value: secret key required వంటి లైన్ ప్రింట్ అయ్యి ఆగిపోతుంది. ఆ సందేశం పాత్ సమస్య, కాన్ఫిగరేషన్ సమస్య కాదు.

ముఖ్యమైన environment విలువలు

మిగిలినవన్నీ ఒకే .env ఫైల్‌లో ఉంటాయి. Authentik ఒక డబుల్ అండర్‌స్కోర్‌ను నెస్టెడ్ కాన్ఫిగరేషన్ కీగా మారుస్తుంది, కాబట్టి AUTHENTIK_EMAIL__HOST అనేది email.hostని సెట్ చేస్తుంది. సింగిల్ అండర్‌స్కోర్ నెస్టెడ్ కీకి మ్యాప్ అవ్వదు, ఒక సెట్టింగ్ పని చేయనట్లు కనిపించడానికి ఇదే అత్యంత సాధారణ కారణం.

  • AUTHENTIK_BOOTSTRAP_PASSWORD అనేది మొదటిసారి ప్రారంభించినప్పుడు అంతర్నిర్మిత akadmin యూజర్ యొక్క పాస్‌వర్డ్‌ను సెట్ చేస్తుంది, తద్వారా మీరు పబ్లిక్ వెబ్ ఫారమ్‌లో దేనినీ టైప్ చేయాల్సిన అవసరం ఉండదు. AUTHENTIK_BOOTSTRAP_EMAIL మరియు AUTHENTIK_BOOTSTRAP_TOKEN అదే విధంగా ఆ యూజర్ యొక్క అడ్రస్ మరియు API టోకెన్‌ను సెట్ చేస్తాయి.
  • COMPOSE_PORT_HTTP మరియు COMPOSE_PORT_HTTPS పబ్లిష్ చేసిన పోర్ట్‌లను డిఫాల్ట్ 9000 మరియు 9443 నుండి మారుస్తాయి.
  • AUTHENTIK_EMAIL__HOST, AUTHENTIK_EMAIL__PORT, AUTHENTIK_EMAIL__USERNAME, AUTHENTIK_EMAIL__PASSWORD, AUTHENTIK_EMAIL__USE_TLS మరియు AUTHENTIK_EMAIL__FROM అవుట్‌బౌండ్ మెయిల్‌ను కాన్ఫిగర్ చేస్తాయి. ఇవి లేకపోతే, Authentik పోర్ట్ 25లో localhostని ప్రయత్నిస్తుంది, దీనివల్ల పాస్‌వర్డ్-రీసెట్ మెయిల్‌లు వర్కర్ లాగ్‌లో కనెక్షన్ ఎర్రర్‌గా ముగుస్తాయి.
  • లాగిన్ ఫ్లో సరిగ్గా పని చేయనప్పుడు మీకు కావలసిన వివరాలను AUTHENTIK_LOG_LEVEL=debug ఆన్ చేస్తుంది. ఆ తర్వాత దానిని తిరిగి infoకి మార్చండి.
  • AUTHENTIK_ERROR_REPORTING__ENABLED డిఫాల్ట్‌గా falseలో ఉంటుంది. మీరు క్రాష్ రిపోర్ట్‌లను అప్‌స్ట్రీమ్‌కు పంపడానికి సిద్ధంగా ఉంటేనే దీనిని trueకి సెట్ చేయండి.

ఇవి ప్లెయిన్ ఫైల్‌లో ఉండే రహస్యాలు (secrets), కాబట్టి ఈ డైరెక్టరీని మీరు ఇతర క్రెడెన్షియల్ స్టోర్‌లను చూసే విధంగానే జాగ్రత్తగా చూడండి. రికవరీ కాపీని మీ ల్యాప్‌టాప్‌లో నోట్‌గా ఉంచడం కంటే, self-hosted Vaultwarden instance వంటి పాస్‌వర్డ్ మేనేజర్‌లో భద్రపరచడం మంచిది.

మొదటి లాగిన్ మరియు అడ్మిన్ ఖాతా

బ్రౌజర్‌లో http://SERVER_IP:9000 ఓపెన్ చేయండి. Authentik దాని ప్రారంభ సెటప్ ఫ్లోను చూపిస్తుంది మరియు డిఫాల్ట్ akadmin వినియోగదారు కోసం పాస్‌వర్డ్‌ను సెట్ చేయమని అడుగుతుంది. మీరు ఇప్పటికే AUTHENTIK_BOOTSTRAP_PASSWORD సెట్ చేసి ఉంటే, ఆ దశ పూర్తయినట్లే మరియు మీరు నేరుగా లాగిన్ పేజీకి వెళ్తారు.

Directory మరియు Users విభాగంలో మీ కోసం ఒక సాధారణ అడ్మిన్ వినియోగదారుని సృష్టించండి, వారిని authentik Admins గ్రూప్‌లో చేర్చి, ఆ ఖాతాతో లాగిన్ అవ్వండి. akadmin ను అత్యవసర పరిస్థితుల కోసం (break-glass account) ఉంచి, దానికి పొడవైన పాస్‌వర్డ్‌ను ఆఫ్‌లైన్‌లో భద్రపరచండి. ఏదైనా ఫ్లో లేదా స్టేజ్ విఫలమై మిమ్మల్ని లాక్ చేస్తే, /opt/authentik నుండి docker compose run --rm server create_recovery_key 10 akadmin రన్ చేయండి; ఇది మిమ్మల్ని నేరుగా akadmin గా లాగిన్ చేసే లింక్‌ను ప్రింట్ చేస్తుంది. ఆ లింక్ ఉన్న ఎవరికైనా అదే యాక్సెస్ ఉంటుంది, కాబట్టి దాన్ని పాస్‌వర్డ్ లాగే జాగ్రత్తగా చూడండి. షేర్డ్ అకౌంట్‌తో రోజువారీ పనులు చేయడం వల్ల ఆడిట్ లాగ్ దెబ్బతింటుంది, ఎందుకంటే ప్రతి ఈవెంట్ akadmin అని చూపిస్తుంది కానీ ఎవరు చేశారో తెలియదు. ఈ వాదన Authentik తర్వాత కూడా వర్తిస్తుంది: ప్రతి వ్యక్తికి వారి స్వంత ఏజెంట్‌ను ఇచ్చే self-hosted OneCLI హార్నెస్ వంటివి, ఆ ఐడెంటిటీ ఒక వ్యక్తికి చెందినదైతేనే స్పష్టమైన లాగ్ ట్రైల్‌ను వదులుతాయి.

Authentik ను మీ reverse proxy వెనుక ఉంచడం

పోర్ట్ 9000 ను ఇంటర్నెట్‌కు పబ్లిష్ చేయడం పనిచేస్తుంది, కానీ మీకు TLS (transport layer security) మరియు సరైన hostname అవసరం. మీరు ఇప్పటికే Traefik as a reverse proxy for multiple Compose apps లోని సెటప్‌ను వాడుతుంటే, ఒక override ఫైల్ ద్వారా Authentik ను అదే external proxy నెట్‌వర్క్‌కు జత చేయండి. compose.yml పక్కన docker-compose.override.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

దీనిని docker compose up -d తో అప్లై చేయండి. Compose ఈ override ను ఆటోమేటిక్‌గా విలీనం చేస్తుంది, కాబట్టి server సర్వీస్ అధికారిక ఫైల్‌లోని అన్ని అంశాలను కలిగి ఉండి, ఈ labels ను పొందుతుంది. curl -I https://auth.example.com/if/user/ తో తనిఖీ చేయండి, ఇది HTTP/2 200 అని సమాధానం ఇవ్వాలి. Traefik నుండి 404 page not found వస్తే, అభ్యర్థనకు సరిపోయే router లేదని అర్థం. Labels కంటైనర్‌కు చేరాయో లేదో, Host() రూల్ hostname తో ఖచ్చితంగా సరిపోలుతుందో లేదో, మరియు అభ్యర్థన router వినే HTTPS entry point కు చేరుతుందో లేదో తనిఖీ చేయండి.

Hostname పనిచేయడం ప్రారంభించిన తర్వాత, override లో పబ్లిష్ చేసిన పోర్ట్‌లను 127.0.0.1 కి బైండ్ చేయండి, తద్వారా proxy ద్వారా మాత్రమే లోపలికి వచ్చే అవకాశం ఉంటుంది.

ఒక అప్లికేషన్‌ను forward authతో రక్షించడం

Authentik యొక్క proxy provider మూడు మోడ్‌లను కలిగి ఉంటుంది, వీటిలో తప్పుదాన్ని ఎంచుకుంటే సమయం వృథా అవుతుంది. Proxy మోడ్ అంటే outpost స్వయంగా ట్రాఫిక్‌ను upstream అప్లికేషన్‌కు పంపుతుంది. Forward auth (single application) అంటే మీ స్వంత reverse proxy ట్రాఫిక్‌ను పంపుతూ, అభ్యర్థన (request) సైన్-ఇన్ అయిందో లేదో మాత్రమే Authentikని అడుగుతుంది. Forward auth (domain level) ఒకే parent domain కింద ఉన్న అన్ని అప్లికేషన్‌లను ఒకే providerతో రక్షిస్తుంది, కానీ దీనివల్ల ప్రతి అప్లికేషన్‌కు విడివిడి authorization నియమాలను సెట్ చేయడం సాధ్యపడదు. ముందు భాగంలో Traefik ఉన్నప్పుడు, మీరు forward auth (single application) ఎంచుకోవాలి. ప్రాక్టీస్ చేయడానికి ఏదైనా అప్లికేషన్ కావాలంటే, self-hosted AFFiNE workspace మంచి ఎంపిక, ఎందుకంటే ఇది మీ పరికరాల నుంచి మాత్రమే అందుబాటులో ఉండాల్సిన అంతర్గత సాధనం. టీమ్ టూల్స్ విషయంలో ఇది మరింత కీలకం: self-hosted Chatwoot support desk ను అదే provider వెనుక ఉంచితే, ప్రతి ఒక్కరూ రోజుకు ఒకసారి సైన్-ఇన్ అయితే సరిపోతుంది, మళ్ళీ మళ్ళీ పాస్‌వర్డ్‌లను పంచుకోవాల్సిన అవసరం ఉండదు.

Web interfaceలో, Applications లోకి వెళ్లి Providers ని ఎంచుకోండి, ఒక Proxy Provider ని సృష్టించండి, forward auth single application మోడ్‌ను ఎంచుకుని, external host ను https://app.example.com కి సెట్ చేయండి. ఆ provider కి పాయింట్ చేసే ఒక Application ని సృష్టించండి. ఆపై Outposts ని ఓపెన్ చేసి, authentik Embedded Outpost ని ఎడిట్ చేసి, కొత్త అప్లికేషన్‌ను దాని selected applications లోకి చేర్చండి. Outpost తనకు కేటాయించిన అప్లికేషన్‌లకు మాత్రమే స్పందిస్తుంది, కాబట్టి ఈ చివరి దశను మర్చిపోతే, provider సరిగ్గా కాన్ఫిగర్ చేసినా ఫలితం ఉండదు.

Middleware ను Authentik కంటైనర్‌పై ఒకసారి నిర్వచించి, ప్రతి protected అప్లికేషన్ నుంచి దానిని రిఫరెన్స్ చేయండి:

      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

authResponseHeaders అనేది Authentik సమాధానం నుంచి Traefik కాపీ చేసి upstream కి పంపే headers జాబితా. దీన్ని వదిలేస్తే అప్లికేషన్ రక్షించబడుతుంది కానీ, యూజర్ ఎవరో దానికి తెలియదు, కాబట్టి X-authentik-username ని రీడ్ చేసే ఆటోమేటిక్ లాగిన్ ఫీచర్లు పనిచేయవు. self-hosted openGym workout tracker వంటి సొంత సైన్-ఇన్ ఉన్న అప్లికేషన్ల ముందు ఈ లోపం స్పష్టంగా కనిపిస్తుంది, అక్కడ headers లేకపోతే ఒకే పేజీ కోసం రెండుసార్లు లాగిన్ అడగాల్సి వస్తుంది.

రక్షించబడిన అప్లికేషన్‌కు ఒకటికి బదులుగా రెండు routers అవసరం:

    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

రెండవ router ను చాలామంది మర్చిపోతుంటారు. సైన్-ఇన్ తర్వాత, Authentik బ్రౌజర్‌ను auth.example.com లో కాకుండా, app యొక్క hostname లోని /outpost.goauthentik.io/ కింద ఉన్న path కి పంపుతుంది. ఆ path prefix ను Authentik సర్వీస్‌కు పంపే router లేకపోతే, request నేరుగా అప్లికేషన్‌కు చేరుతుంది, అక్కడ 404 error వస్తుంది మరియు లాగిన్ పూర్తి కాదు. అధిక priority ఉండటం వల్లే, అదే domain లోని సాధారణ Host() నియమం కంటే ఈ నిర్దిష్ట path నియమం పనిచేస్తుంది.

దీనిని private browser windowలో పరీక్షించండి. మీరు auth.example.com కి పంపబడాలి, సైన్-ఇన్ చేయాలి, ఆపై తిరిగి అప్లికేషన్‌కు రావాలి. Authentik వైపు ఉన్న docker compose logs -f server ప్రతి ప్రయత్నానికి ఒక authorization ఈవెంట్‌ను ప్రింట్ చేస్తుంది, దీని ద్వారా request Authentik కి చేరిందో లేదో తెలుసుకోవచ్చు.

మీరు ఎదుర్కొనే వాస్తవ వైఫల్యాలు

అప్లికేషన్ మరియు లాగిన్ పేజీ మధ్య అంతులేని redirect loop. ప్రొవైడర్‌లోని external host, బ్రౌజర్ ఉపయోగిస్తున్న దానితో సరిపోలడం లేదు, సాధారణంగా ప్రొవైడర్‌లో ఉన్న http:// మరియు అడ్రస్ బార్‌లో ఉన్న https:// మధ్య వ్యత్యాసం ఉంటుంది. దీనివల్ల session cookie వేరే origin కోసం సెట్ చేయబడుతుంది, కాబట్టి ప్రతిసారీ తిరిగి వచ్చే అభ్యర్థన కొత్త anonymous అభ్యర్థనలా కనిపిస్తుంది. external host ను సరిచేసి, మళ్ళీ పరీక్షించే ముందు రెండు డొమైన్‌ల కోసం cookies ను క్లియర్ చేయండి.

/outpost.goauthentik.io/start వద్ద 404 ఎర్రర్. outpost router లేదు, లేదా ఆ host కోసం ఉన్న catch-all router కంటే దీని priority తక్కువగా ఉంది.

లాగిన్ అడగకుండానే అప్లికేషన్ లోడ్ అవుతోంది. middlewares లేబుల్ లేని middleware ను సూచిస్తోంది. Traefik దీని గురించి హెచ్చరించదు, కాబట్టి authentik@docker లో చిన్న అక్షర దోషం ఉన్నా ఏ middleware రన్ అవ్వదు. Traefik dashboard ఓపెన్ చేసి, router లో ఆ middleware జాబితా చేయబడిందో లేదో నిర్ధారించుకోండి.

సక్సెస్‌ఫుల్ లాగిన్ తర్వాత Authentik నుంచి 403 ఎర్రర్. వినియోగదారుడు authenticated అయ్యారు కానీ authorized కాలేదు: అప్లికేషన్‌కు ఒక policy binding లేదా group requirement ఉంది, అది ఈ వినియోగదారునికి వర్తించడం లేదు. అడ్మిన్ ఇంటర్‌ఫేస్‌లోని Events లాగ్‌లో ఏ పాలసీ దీనిని తిరస్కరించిందో చూడవచ్చు.

Keycloak ఎప్పుడు సరైన ఎంపిక అవుతుంది

Keycloak అనేది పాత ప్రాజెక్ట్, దీనికి Red Hat మద్దతు ఉంది. సాంప్రదాయ ఎంటర్‌ప్రైజ్ ఐడెంటిటీ పనులకు ఇది బలమైన ఎంపిక: భారీ SAML ఫెడరేషన్, ఒకేసారి అనేక బాహ్య ఐడెంటిటీ ప్రొవైడర్ల నుండి లాగిన్‌లను బ్రోకర్ చేయడం, మరియు డాక్యుమెంట్ చేయబడిన మైగ్రేషన్ మార్గంగా realm ఎగుమతి మరియు దిగుమతి వంటివి ఇందులో ఉన్నాయి. కొన్ని సంస్థలకు కాగితంపై దీనికి ఉన్న కమర్షియల్ సపోర్ట్ ముఖ్యమైనది. దీనిలో ఉన్న లోపం ఏమిటంటే, Keycloak కు సొంతంగా ప్రాక్సీ లేదు. కాబట్టి OIDC (OpenID Connect) లేదా SAML సపోర్ట్ లేని అప్లికేషన్‌ను రక్షించాలంటే, దాని పక్కన oauth2-proxy వంటి వాటిని నడపాల్సి ఉంటుంది. Authentik లోని అంతర్నిర్మిత ప్రాక్సీ ప్రొవైడర్ ఇప్పటికే ఇంటిగ్రేట్ అయి ఉంటుంది, అందుకే వివిధ రకాల అప్లికేషన్లను self-host చేసే చాలామంది దీనిని ఎంచుకుంటారు.

బ్యాకప్‌లు మరియు అప్‌గ్రేడ్‌లు

మూడు విషయాలు రీస్టోర్‌ను సాధ్యం చేస్తాయి: PostgreSQL డేటాబేస్, ./data డైరెక్టరీ, మరియు .env.

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

ఆ డంప్ మరియు .env ను కలిపి స్టోర్ చేయండి. డంప్‌లో AUTHENTIK_SECRET_KEY కాపీ ఉండదు, మరియు వేరే కీతో రీస్టోర్ చేస్తే ప్రతి యాక్టివ్ సెషన్ రద్దవుతుంది, కాబట్టి అసలు కీని ఉంచుకోవడం వల్ల రీస్టోర్ చేసిన సర్వర్ పాత స్థితిలోనే కొనసాగుతుంది.

అప్‌గ్రేడ్‌లు అంటే ట్యాగ్ మార్చడం. .env లో AUTHENTIK_TAG ను మీకు కావలసిన రిలీజ్‌కు సెట్ చేయండి, ఆపై docker compose pull రన్ చేసి, దాని తర్వాత docker compose up -d రన్ చేయండి. మీరు AUTHENTIK_TAG సెట్ చేయకపోతే, వెర్షన్ compose.yml లో రాసి ఉన్న డిఫాల్ట్ నుండి వస్తుంది, కాబట్టి ఆ ఫైల్ యొక్క కొత్త కాపీని డౌన్‌లోడ్ చేయడమే అప్‌గ్రేడ్, మరియు అధికారిక అప్‌గ్రేడ్ డాక్యుమెంట్స్ ఇదే మార్గాన్ని వివరిస్తాయి. ముందుగా రిలీజ్ నోట్స్ చదవండి. Authentik తేదీ ఆధారిత వెర్షన్లను ఉపయోగిస్తుంది, అక్టోబర్ 2026 నాటికి డాక్యుమెంట్స్ ప్రకారం అప్‌గ్రేడ్‌లు మేజర్ రిలీజ్ క్రమంలో జరగాలి: మీరు రన్ చేస్తున్న సిరీస్‌లోని లేటెస్ట్ ప్యాచ్‌కు మారండి, ఆపై ఏదీ వదలకుండా తర్వాతి సిరీస్‌లకు వెళ్లండి. Authentik డౌన్‌గ్రేడింగ్‌కు మద్దతు ఇవ్వదు, కాబట్టి పుల్ చేయడానికి ముందే డేటాబేస్ డంప్ తీసుకోండి.

FAQ

Authentik ను self-host చేసుకోవడం ఉచితమేనా?

దీని open source ఎడిషన్ ఉచితం మరియు పైన పేర్కొన్న అన్ని ఫీచర్లను అందిస్తుంది: proxy provider, forward auth, OIDC (OpenID Connect), SAML, మరియు flows engine. చెల్లింపుతో కూడిన enterprise tier లో మద్దతు (support) మరియు కొన్ని ప్రత్యేక enterprise ఫీచర్లు ఉంటాయి, కానీ ఇక్కడ వివరించిన దేనికీ లైసెన్స్ అవసరం లేదు.

Authentik వాడటానికి నాకు Traefik అవసరమా?

అవసరం లేదు. Forward auth అనేది nginx తో auth_request ద్వారా, Caddy తో forward_auth ద్వారా పనిచేస్తుంది. అన్ని సందర్భాల్లోనూ పద్ధతి ఒకటే: ప్రతి అభ్యర్థన (request) గురించి reverse proxy, Authentik ను అడుగుతుంది. రక్షించబడిన hostname పై ఉన్న path prefix /outpost.goauthentik.io/, అప్లికేషన్‌కు బదులుగా Authentik వైపు మళ్లించబడాలి.

నా protected app లాగిన్ మరియు ఎర్రర్ పేజీల మధ్య ఎందుకు పదే పదే తిరుగుతోంది?

Proxy provider లో కాన్ఫిగర్ చేసిన external host, బ్రౌజర్ ఉపయోగిస్తున్న URL తో సరిపోలడం లేదు. సాధారణంగా ఇది http మరియు https మధ్య తేడాల వల్ల జరుగుతుంది. Session cookie ఒక origin కోసం జారీ చేయబడి, మరొక దానిపై చదవబడుతోంది, కాబట్టి Authentik ప్రతిసారీ అభ్యర్థనను anonymous గానే చూస్తుంది. External host ను సరిచేసి, మళ్లీ పరీక్షించే ముందు రెండు hostname ల కోసం cookies ను క్లియర్ చేయండి.

Authentik కు ఎంత RAM అవసరం?

అక్టోబర్ 2026 నాటికి, డాక్యుమెంట్ చేయబడిన కనీస అవసరం 2 CPU కోర్లు మరియు 2 GB RAM. ఇది PostgreSQL, సర్వర్ మరియు worker మూడింటికీ కలిపి సరిపోతుంది. 2 GB ఉన్న సర్వర్‌లో, మెమరీ ఒత్తిడి పెరిగితే kernel యొక్క OOM killer యాక్టివేట్ అవ్వవచ్చు. ఇది అత్యధిక badness score ఉన్న ప్రాసెస్‌ను నిలిపివేస్తుంది: అంటే అది వాడుతున్న మెమరీ వాటా మరియు దాని oom_score_adj. ఒకవేళ worker ప్రాసెస్ నిలిచిపోతే, లాగిన్ పేజీ పనిచేస్తూనే ఉంటుంది కానీ background tasks మరియు outbound email ఆగిపోతాయి. మీరు రక్షిస్తున్న అప్లికేషన్లు కూడా అదే సర్వర్‌లో నడుస్తుంటే, దానికి 4 GB RAM కేటాయించండి.

ఈ వ్యాసం ఉపయోగకరంగా ఉందా?