freshrss/edge/docs/en/admins
16_OpenID-Connect-Authentik| modified | Tuesday 15 September 2026 |
|---|
authentik is an open-source Identity Provider compatible with OpenID Connect (OIDC) (see FreshRSS’ OpenID Connect documentation).
You can find more information in authentik integrations documentation.
In authentik Web interface:

Select OAuth2/OpenID Provider. Click Next.
Give it a name, and select your desired auth flows (default flows for this example).
Select Confidential Client Type.

Copy the ID / secret for later (you can also come back and get it later).
Set the redirect URIs for FreshRSS: If FreshRSS’ root is https://freshrss.example.net/, the proper redirect URI would be https://freshrss.example.net:443/i/oidc/.
Note the port number is required even if you are using standard ports (443 for HTTPS).
Without the port number, Authentik will give a redirect_url error.
You will need to choose a signing key.
If you don’t have one, generate one under System > Certificates.
The default authentik Self-Signed Certificate will also work.
If using a self-signed certificate issued by your own CA, you will need to mount the following file to the FreshRSS container: /etc/ssl/certs/ca-certificates.crt:ro. Note: The ca-certificates.crt need to be mounted as read-only :ro to avoid any unwanted modification.
Under Advanced Protocol Settings > Scopes you will see that email, openid and profile are selected by default.
These are the scopes you will set later in the docker config file.

After you have created the provider, you will need to create an application for it.

Once created, go to Applications in Authentik, then select the FreshRSS application you just made.
Select the Policy > Group > User Bindings tab at the top.
This is where you define which of your Authentik users are allowed to access this application (FreshRSS).
Select Bind existing policy then select either the group or the user tab to add a group of users or a specific user.
ℹ️ Suggestion: make a group such as
app-usersandapp-admin-usersso that you can simply add entire groups to applications. Then when new users are made, they are just added to the group and all your applications will allow them to authenticate.

Finally, go to Providers, and click on the OIDC provider you created for FreshRSS.
You will want to copy the OpenID Configuration URL value listed.
You will need this in the next step.
Note: this is using a Kubernetes ConfigMap.
However, these are just environment variables mapped into the container.
1apiVersion: v1
2kind: ConfigMap
3metadata:
4 name: freshrss-config
5 namespace: freshrss
6data:
7 PGID: "100"
8 PUID: "65534"
9 CRON_MIN: "*/15"
10 OIDC_ENABLED: "1"
11 # Put your "OpenID Configuration URL" here, from the previous step:
12 OIDC_PROVIDER_METADATA_URL: https://authentik.example.net/application/o/freshrss/.well-known/openid-configuration
13 OIDC_REMOTE_USER_CLAIM: preferred_username
14 # Put your ID here, from the previous step:
15 OIDC_CLIENT_ID: t48O5c6z2Ia1XXXXXXX
16 # Put your secret here, from the previous step:
17 OIDC_CLIENT_SECRET: tDUhtfgxY5mCIZ1M1ItauXXXXX
18 # TODO: I have no idea what goes here, but a random string seems to work just fine:
19 OIDC_CLIENT_CRYPTO_KEY: WnoO3kRzXynag2XXXXXXXXXX
20 OIDC_SCOPES: "openid profile"
21 # These headers work for Traefik.
22 # May need to be adjusted depending on your proxy configuration:
23 OIDC_X_FORWARDED_HEADERS: X-Forwarded-Host X-Forwarded-Port X-Forwarded-Proto
Secrets can advantageously be put in an .env instead of the docker-compose file:
1# Taken from authentik oAuth Provider Settings page
2OIDC_PROVIDER_METADATA_URL=???
3# Taken from authentik oAuth Provider Settings page
4OIDC_CLIENT_ID=???
5# Taken from authentik oAuth Provider Settings page
6OIDC_CLIENT_SECRET=???
7# Randomly generated password
8OIDC_CLIENT_CRYPTO_KEY=???
This is a full example docker-compose file. It uses Traefik reverse proxy, Authentik for OAuth.
1# you will need to define these volumes base on your setup
2volumes:
3 freshrss-data:
4 freshrss-extensions:
5
6networks:
7 traefik_proxy:
8 name: traefik_proxy
9 external: true
10
11services:
12 freshrss:
13 image: freshrss/freshrss:edge
14 container_name: freshrss
15 hostname: freshrss
16 networks:
17 - traefik_proxy
18 restart: unless-stopped
19 logging:
20 options:
21 max-size: 10m
22 volumes:
23 - freshrss-data:/var/www/FreshRSS/data
24 - freshrss-extensions:/var/www/FreshRSS/extensions
25 - /etc/ssl/certs/ca-certificates.crt:/etc/ssl/certs/ca-certificates.crt:ro # If using self-signed authentik signing-key issued by your own CA
26 # # Portainer defines the env file as show below, but not needed if using the default `.env`
27 # env_file:
28 # - ../stack.env
29 environment:
30 TZ: America/Chicago
31 CRON_MIN: '1,31'
32 TRUSTED_PROXY: 172.18.0.30 # internal Docker traefik IP address, could use 172.18.0.1/24 instead to allow the entire internal Docker network to proxy
33 OIDC_ENABLED: 1
34 OIDC_X_FORWARDED_HEADERS: X-Forwarded-Host X-Forwarded-Port X-Forwarded-Proto
35 OIDC_SCOPES: openid email profile
36 OIDC_REMOTE_USER_CLAIM: preferred_username
37 labels:
38 - "traefik.enable=true"
39 - "traefik.docker.network=traefik_proxy"
40 - "traefik.http.routers.fressrss.rule=Host(`rss.example.net`)"
41 - "traefik.http.routers.fressrss.entrypoints=https"
42 - "traefik.http.routers.fressrss.tls.certresolver=myresolver"
43 - "traefik.http.routers.fressrss.service=fressrss"
44 - "traefik.http.services.fressrss.loadbalancer.server.port=80"
ℹ️ Not sure where
preferred_usernameis defined in authentik but using that does work. This does not need to be changed to something else. Note that the authentik documentation states:By default, every user that has access to an application can request any of the configured scopes.
During FreshRSS initial setup, or inside of the authentication settings for FreshRSS, set the authentication method to HTTP.
See FreshRSS’ OpenID Connect documentation for more information.