Is KMReader compatible with Komga?
Yes. KMReader works with any Komga 1.20.0 or later server, including KMServer.
Frequently asked questions
Komga compatibility, migration, offline reading, and platforms.
Do I need to reorganize or re-import my library?
No. KMServer reads your existing library directories in place, with the same structure Komga uses. Your files stay where they are.
Can KMServer use my existing database?
Yes. Point it at an existing Komga data directory and it upgrades database.sqlite in place with byte-for-byte Flyway migrations. The Java version can still open the result, so you can switch back. KMServer-only data such as smart lists and tracker links lives in a separate kmrs.sqlite file that the Java version ignores.
Can I continue using other Komga clients?
Yes. KMServer speaks the same API: REST, OPDS v1.2/v2, SSE, Kobo and KOReader sync. Your existing clients connect to the same address; some may ask you to sign in again.
Is KMServer a full Komga replacement or a lightweight subset?
KMServer is a full-featured drop-in replacement for Komga, not a CBZ/CBR-only subset. It supports the same library formats, API, and database, and adds capabilities such as smart lists, reading trackers, CJK cross-search, webhooks, and reading statistics. It also runs without a JVM, with bounded memory and container caches for efficient page serving. The few accepted gaps are documented. Known limitations →
Which file formats does KMServer support?
KMServer scans CBZ/ZIP, CBR/RAR, PDF, and EPUB books. Webtoon is a reading presentation for compatible books, not a separate file format.
How can KMServer support PDF and EPUB while staying lightweight?
PDF pages are rendered on demand by libpdfium instead of PDFBox on a JVM. The Docker image includes libpdfium; standalone installations must provide it. EPUB packages are parsed on the server, while compatible readers handle layout using the served metadata, navigation, and resources.
Does KMReader work offline?
Yes. Downloaded books stay fully readable offline: pages, covers, metadata and progress are stored locally.
Does reading progress sync?
Yes. Progress is tracked offline first and synced to your server when you reconnect, so it follows you across devices.
Does KMReader support EPUB?
Yes, on iOS and macOS, with themes, fonts, and layout controls.
Does KMReader support PDF?
Yes, on iOS and macOS: a native PDF reader for text-heavy books, or the comic reader for comic and manga PDFs.
Which reader does KMReader use for comics and manga?
DIVINA, KMReader's image reader for comics, manga, and webtoons. It is available on every platform: iOS, macOS, and tvOS.
Does KMReader work on Mac?
Yes. KMReader is a native macOS app (macOS 14.0 or later) with dedicated reader windows, menu bar actions, and keyboard-first controls.
Does KMReader work on Apple TV?
Yes. KMReader is a native tvOS app (tvOS 17.0 or later) with remote-first DIVINA reading.
Can KMReader connect to multiple servers?
Yes. Save several servers, switch between them at any time, and sign in with a password or an API key.
Is kmworks open source?
Yes. Every kmworks project is MIT licensed: KMServer, KMReader, and the web UI.
Is kmworks affiliated with Komga?
No. kmworks is built for the Komga ecosystem but is independent of it, and is not affiliated with the Komga project.
What is kmrs?
kmrs stands for KM Rust Server. It is the name of the repository, Docker image, and binary; the product is KMServer.