Komga

Media server for comics, manga, graphic novels, and eBooks.

Quick Reference

Field	Value
URL	https://manga.bogocat.com
Internal	http://10.89.97.50:25600
Location	arr-stack VM (Docker)
Auth	Authentik SSO (native OIDC)

Features

• Web-based comic/manga reader with multiple reading modes
• OPDS v1/v2 support for e-readers
• Kobo and KOReader sync
• Multi-user with access controls
• Automatic metadata detection

Supported Formats

CBZ, CBR, PDF, EPUB

Configuration

Docker Compose

Location: /opt/arr-stack/docker-compose.yml on VM 100

komga:
  image: gotson/komga:latest
  container_name: komga
  environment:
    - TZ=America/New_York
    - KOMGA_OIDC_EMAIL_VERIFICATION=false
    - JAVA_TOOL_OPTIONS=-Xmx2g
  user: "1000:1000"
  volumes:
    - /opt/arr-stack/configs/komga:/config
    - /mnt/media:/data
  ports:
    - "25600:25600"
  restart: unless-stopped

Authentik OIDC

Configuration in /opt/arr-stack/configs/komga/application.yml:

komga:
  oauth2-account-creation: true
  oidc:
    email-verification: false

spring:
  security:
    oauth2:
      client:
        registration:
          authentik:
            provider: authentik
            client-id: <from-authentik>
            client-secret: <from-authentik>
            client-name: Authentik
            scope: openid,email,profile
            authorization-grant-type: authorization_code
            redirect-uri: "{baseUrl}/{action}/oauth2/code/{registrationId}"
        provider:
          authentik:
            issuer-uri: https://auth.bogocat.com/application/o/komga/
            user-name-attribute: preferred_username

Authentik Setup

1. Create OAuth2/OpenID Provider:
2. Name: komga-provider
3. Redirect URI: https://manga.bogocat.com/login/oauth2/code/authentik

4. Scopes: openid email profile

5. Create Application:

6. Name: Komga
7. Slug: komga

8. Provider: komga-provider

9. User email must be verified in Authentik, OR set KOMGA_OIDC_EMAIL_VERIFICATION=false

Adding Libraries

1. Go to Server Settings (gear icon) → Libraries
2. Click "Add Library"
3. Point to a path under /data/ (e.g., /data/comics)
4. Komga will scan and organize automatically

Paths

Container Path	Host Path	Purpose
/config	/opt/arr-stack/configs/komga	Database, settings
/data	/mnt/media	Media files

Troubleshooting

"Email not verified" error

Set KOMGA_OIDC_EMAIL_VERIFICATION=false in docker-compose environment, or mark user email as verified in Authentik.

OAuth login not appearing

Ensure application.yml is in /config directory and contains valid OIDC configuration.