OpenSource-Hub
K

Komga

6.2k stars·System Optimization·SHA-256 checksum verified

Komga is a media server for comics, mangas, BDs, magazines and eBooks. It features a responsive web reader, user management, metadata import, collections, and supports OPDS, Kobo Sync and KOReader Sync.

Smart Download

Visit Project Homepage

No installer available yet — head to the source repository

Self-hosted media server for comics, mangas and ebooks with sync support.

Core Features

  • Media server supporting comics, mangas, BDs, magazines, and eBooks
  • Responsive web reader works on desktop, tablet, and phone
  • Multi-user with per-library access control and age restrictions
  • Automatic embedded metadata import, editable metadata
  • Kobo Sync and KOReader Sync support

What It Can't Do

  • This software is designed for comics and ebooks only, no video or music support. Not intended for encrypted CBR files. Initial setup requires manual configuration of library paths; plan your storage accordingly.

Use Cases

  • Build a personal digital library of comics and ebooks accessible from any device
  • Sync reading progress between Kobo/KOReader and other devices

Detailed Introduction

Komga 是一款专为漫画、杂志、电子书设计的自托管媒体服务器。它提供响应式网页阅读器,支持多用户管理、元数据编辑、集合整理,并通过 REST API、OPDS、Kobo Sync 和 KOReader Sync 实现与多种阅读设备的无缝同步。基于 MIT 开源协议,社区活跃,文档完善。

Troubleshooting & FAQ (2)

Troubleshooting
Why does Komga return 400 Bad Request when syncing reading state for Kobo store books?

This is a known issue with Komga's Kobo proxy. The fix is available on the koboproxy branch: https://github.com/gotson/komga/tree/koboproxy. Build Komga from that branch to resolve the 400 Bad Request error. Alternatively, the fix from PR #2291 also works. A permanent fix will be included in a future release.

GitHub Issue #2289
Troubleshooting
Why do Komga series sharing labels disappear after restarting the Docker container when using an NFS mount for the library?

This is caused by an NFS mount race condition. If the NFS share is not fully mounted before Komga starts, the library scan sees an empty directory and treats it as a new, empty library. This triggers a full library rebuild with new series IDs, orphaning existing series sharing labels and other metadata linked to the old IDs. To prevent this, configure the library directory to a sub-directory within the NFS mount (e.g., /data/komga instead of the mount root /data). When the mount is missing, Komga will then detect the library folder as unavailable rather than empty, preserving existing series IDs and metadata.

GitHub Issue #2278

Tags

漫画电子书媒体服务器自托管同步阅读

Getting Started

1

Download installer

Click the button above to download the installer for your system

2

Install the software

Double-click the downloaded installer and follow the prompts

3

Download the latest release from GitHub Releases or Docker Hub

4

Run the application (Docker: docker run gotson/komga, or java -jar komga.jar)

5

Open http://localhost:8080 in browser, create admin account to start

Install Guide
  1. Download the latest release from GitHub Releases or Docker Hub
  2. Run the application (Docker: docker run gotson/komga, or java -jar komga.jar)
  3. Open http://localhost:8080 in browser, create admin account to start
File Integrity

Checksum not available

This project has not published a SHA-256 checksum on its GitHub Release page

SHA256 Checksum

No checksum available

Download directly from GitHub Releases and verify file integrity yourself

All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.

Open Source Transparency

View GitHub Source
Environment Guide

Uninstall Info

For Docker: stop and remove the container, then delete the mapped volumes. For jar: delete the komga folder and database files.

No Extra Dependencies

Ready to use after download. No additional runtime required.

Project Info
LicenseMIT
Last Updated2026-06-27 08:25:20
GitHub RepositoryOfficial Website

Having issues? Check the FAQ below

2 FAQs

Similar Projects