Skip to main content

Komga

A self-hosted comics and manga server.

Decommissioned

Komga was removed from the Talos cluster in August 2026 and replaced by Stump. It served the manhwa and comics library on the TrueNAS reading share reliably for over a year, but by then it had become a second index over files that Suwayomi already downloads and tracks — no reading progress had been recorded in Komga since November 2025 — and Stump covers the same ground (CBZ/EPUB/PDF readers, OPDS, Kobo/KOReader sync, native OIDC) at a fraction of the footprint. The manifests under k8s/apps/komga/, the Flux entry, and the k8up restore snippet are gone; this page stays as the record of what ran and why it went.

Komga is an open-source media server for comics, manga, and digital books. It organizes CBZ/CBR/PDF files, provides a web reader and OPDS feed, and supports reading progress sync across devices. Self-hosting avoids subscription fees and keeps your collection on your own hardware.

Alternatives considered​

Cloud Hosted

ToolOpen SourceFree TierMonthly Cost
ComiXology UnlimitedNoNo$5.99/mo

Self Hosted

ToolOpen SourceFull FeaturesNotes
KavitaYesYesBooks, manga, and comics; similar scope
StumpYesBetaRust, much lighter, native OIDC + Kobo/KOReader sync — evaluated in parallel and chosen as the replacement in August 2026

Installation​

Architecture​

  • Deployment: Single komga deployment in the komga namespace
  • Image: gotson/komga:1.26.3 (digest-pinned; last version deployed)
  • Storage: Longhorn PVC (komga-data, 1Gi, annotated k8up.io/backup: "true") for database and config; NFS volume from TrueNAS for the books library
  • Networking: HTTPRoute via public gateway

Security​

  • Runs as runAsUser: 0, runAsNonRoot: false
  • Longhorn PVC encrypted at rest via SOPS-managed keys

Updates​

Was managed by Renovate with a digest-pinned image until the app was removed.

Data Management​

  • PVC: komga-data (1Gi, Longhorn-encrypted, k8up.io/backup: "true") for embedded database and config
  • NFS: TrueNAS NFS volume for books library (read-only)
  • Backups: the Longhorn PVC was backed up by k8up via restic until the app was removed.

User Management​

OIDC login was via Keycloak, configured through Spring Security's OAuth2 client registration (SPRING_SECURITY_OAUTH2_CLIENT_REGISTRATION_KEYCLOAK_* / ..._PROVIDER_KEYCLOAK_* env from the komga-oidc ConfigMap, client secret from the SOPS-encrypted komga-oidc Secret). Komga matches an OIDC login to a local account by e-mail; KOMGA_OAUTH2_ACCOUNT_CREATION provisions a non-admin user for unknown verified e-mails. Admin rights and library access are still granted in the Komga web UI; password login remains available for the admin account.

Configuration Management​

  • k8up restic password and Longhorn encryption key from SOPS-encrypted secrets

Usage​

Add library folders pointing to your comics or manga directories. Komga scans and builds a metadata database automatically. Read books in the built-in web reader or use a compatible OPDS reader on mobile (e.g., Chunky, Moon+ Reader). Reading progress syncs across all connected clients.

No cluster deploys Komga any more; its Talos overlay was removed in August 2026 when Stump took over the library.