selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Komga logo

Self-host Komga

1.30.1

Media server for comics, manga, and eBooks with OPDS sync

ReleaseOpen SourceMIT
Updated6 days ago
LanguageKotlin
Setup difficultyModerate
MobileResponsive
Stars
6 851
Port
25600 (API and web interface)
Docker
gotson/komga
Install with Docker Compose

What is Komga?

Komga organizes and serves comics, manga, BDs, magazines, and eBooks (CBZ, CBR, PDF, EPUB). A responsive web interface adapts to desktop, tablet, and phone screens, with a built-in webreader offering multiple reading modes. Features include library organization via collections and read lists, metadata editing with automatic import from embedded data, OPDS v1/v2 feeds for third-party readers, Kobo eReader and KOReader progress sync, a REST API for automation, multi-user management with per-library access control and age/label restrictions, duplicate file and page detection, and ComicRack read list import. Deployment options: Docker, JAR file (Java 17+), native desktop apps for Windows/macOS, or Microsoft Store. Uses embedded SQLite databases and defaults to port 25600. A demo instance runs at demo.komga.org.

Komga alternatives

Should you self-host Komga?

Komga scores 72/100 on selfhost.directory (how scoring works) and ranks #6 of 119 in Media Server. It has 6 851 GitHub stars, +114 in the last 30 days.

It shipped 20 stable releases in the past year. The latest, 1.30.1, came out on 10 November 2026. New versions land roughly every 7 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Kotlin.

Its closest alternative on selfhost.directory is Jellyfin (88/100, 59 415 stars). It scores higher overall, so compare the two before you pick. See Komga vs Jellyfin side by side.

Features

  • Automatic metadata import
  • Collections and read lists
  • ComicRack import
  • Duplicate Detection
  • External import
  • File Download
  • Kobo Sync
  • KOReader Sync
  • Metadata Editing
  • Multi-User Management
  • OAuth2/OIDC social login
  • OPDS v1/v2 support
  • REST API
  • Web-based library browser
  • Webreader

Komga README

Open Collective backers and sponsors GitHub Sponsors Discord

GitHub release (latest SemVer) GitHub all releases Docker Pulls

Translation status

app icon Komga

Komga is a media server for your comics, mangas, BDs, magazines and eBooks.

How to install Komga

Install Komga with Docker Compose

Docker Compose

version: '3.3' services: komga: image: gotson/komga container_name: komga volumes: - type: bind source: /path/to/config target: /config - type: bind source: /path/to/data target: /data ports: - 25600:25600 user: "1000:1000" environment: - TZ=Europe/London - <ENV_VAR>= restart: unless-stopped

Images published on Docker Hub and ghcr.io

Komga releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

Docker on Raspberry PI arm32: No monotonic clock was available

Requires Docker 19.03.9+ and libseccomp 2.4.2+ on the host system.

Scan doesn't pick up new files under mergerfs

Add func.getattr=newest to mergerfs mount options in /etc/fstab to update modified times.

How can I move a library to a different folder?

Enable file hashing, disable auto-empty trash, scan library, stop Komga, move files, restart, update library root path, rescan.

This server has already been claimed

A user already exists in the database. Delete the database file (~/.komga/database.sqlite) to reset.

My books/series show a different name than the files/folders

Komga imports metadata from EPUB and ComicInfo.xml which overrides file/folder names.

Media type application/x-7z-compressed is not supported

7zip archives are not supported. Extract and re-compress as ZIP (CBZ).

Webreader double pages are not showing as single page

Double pages require image sizes from analysis v0.51.0+. Re-analyze books imported before that version.

How can I sync reading progress with tracker websites?

Komga doesn't support this natively. Try MAL-Sync which integrates with Komga and works with MyAnimeList, Kitsu, AniList and others.

Komga seems slow, how can I check what's going on?

An animated yellow bar appears below the top-left logo when activity is in progress. Hover it to see pending task details.

Where can I find the log files?

Logs are in ~/.komga/komga.log (jar), /config/logs/komga.log (Docker), or platform-specific locations for desktop apps.

I forgot my password

Ask an admin to reset it, or use the CLI reset command.

More in Media Server

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…