Skip to main content
App Information

Komga

A self-hosted comics and manga server.

About

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.

AlternativeTo

Cloud Hosted

ToolOpen SourceFree TierMonthly Cost
ComiXology UnlimitedNoNo$5.99/mo

Self Hosted

ToolOpen SourceFull FeaturesNotes
KavitaYesYesBooks, manga, and comics; similar scope

Installation

Architecture

  • Deployment: Single komga deployment in the komga namespace
  • Image: gotson/komga:1.24.3 (digest-pinned)
  • 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

Managed by Renovate. Image is digest-pinned.

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: k8up Schedule backs up the Longhorn PVC to Hetzner S3 via restic.

User Management

No OIDC env vars in manifests. User accounts managed through the Komga web UI. Komga supports OIDC natively but it is not configured here.

Configuration Management

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

Administration

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.

Metadata

Kubernetes Metadata
  • Image: gotson/komga:1.24.3@sha256:517033528928003d730e6d3ae99c74470e23938e3f3954924a60dd069bd28c5a