Video coming soon…

🗂️ Setup Komga — Self-Hosted Comics & Manga Server

Serve your comics and manga collection from your own server with Komga — an open-source media server with OPDS support and a clean web reader.

⚠️ This script is provided for demo and testing purposes only. Not intended for production use.

📦 Resources & Setup Scripts

Grab the automated bash script from GitHub to follow along with the video.

Automated install script — one command sets everything up.
View on GitHub

Quick Install:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/media/komga/komga-ubuntu.sh
chmod +x komga-ubuntu.sh
sudo bash komga-ubuntu.sh

Tutorial Steps

1 Download the Script

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/media/komga/komga-ubuntu.sh

2 Make it Executable

chmod +x komga-ubuntu.sh

3 Run the Installer

The script installs Docker if needed, then sets up the service automatically.

sudo bash komga-ubuntu.sh

4 Access the Web UI

Open your browser and navigate to:

http://<your-server-ip>:25600

5 Add Your Library

Go to Libraries → Add Library and point it to your comics or manga directory. Komga reads series and volumes automatically from the folder structure.

Ports Used

PortPurpose
25600Komga Web UI

Overview

Komga is an open-source comics and manga server built on Spring Boot. It organises your collection by series and volumes using folder structure, fetches metadata from ComicInfo.xml files, and exposes an OPDS catalog so dedicated comic reader apps on any device can connect. The web reader supports double-page spreads and reading direction settings.

Why Use It

A folder of 10,000 CBZ files is not a library — it is an archive you cannot navigate. Komga gives that collection structure: series detection, volume ordering, reading progress tracking, and a web reader that works in any browser. The Tachiyomi/Mihon integration means your phone becomes a mobile manga reader synced to your server. Share your collection with household members — each person gets their own reading progress and bookmarks.

When You Need It

    Who Should Use It

      Real Use Cases

        Main Features

          How to Use After Installation

            Security Best Practices

              Ports and Firewall Notes

              Komga serves its web UI and OPDS catalog on port 25600 by default. For home network use, access directly via the IP and port. For external access or HTTPS (required for Tachiyomi and some OPDS readers), proxy through Nginx Proxy Manager. No other ports are required — Komga is a single-container application with an embedded H2 database.

              Backup and Maintenance

                Common Mistakes

                  Troubleshooting

                    Alternatives

                    Kavita (broader format support including audiobooks and novels, similar UI), Ubooquity (Java-based, older, less actively maintained), Mylar3 (comic management but no reader), CDisplayEx (local Windows reader, no server). Komga is the best choice for CBZ/CBR manga collections with Tachiyomi/Mihon mobile reading and Kobo sync requirements.

                    When Not to Use It

                    Skip Komga if you primarily read ebooks (EPUB novels) rather than comics — Kavita handles mixed libraries including novels better. Also skip it if you want a fully featured e-book manager with Calibre metadata editing — Calibre-Web is more appropriate for that use case. For reading a small collection of fewer than 100 volumes, a simple file manager or local app may be sufficient.

                    PrismaTechWork Professional Help

                    PrismaTechWork provides end-to-end infrastructure services — from initial deployment and security hardening to ongoing monitoring, automated backups, and dedicated support. Whether you need a single-server setup or a multi-site network, our team ensures your infrastructure is built right, secured properly, and maintained reliably.

                      Contact Us

                      Frequently Asked Questions

                      How do I connect Tachiyomi or Mihon to Komga?

                      In Tachiyomi or Mihon, go to Browse → Sources → find the Komga source (install via the extension repository if not present). Add a new Komga source with your server URL (e.g. https://your-domain or http://192.168.1.x:25600), your Komga username, and password. The source displays your Komga libraries and series exactly as they appear in the web UI, with reading progress synced in real time between the app and the server.

                      What file formats does Komga support?

                      Komga supports CBZ (ZIP-based comic archive), CBR (RAR-based), CB7 (7-Zip-based), CBT (TAR-based), PDF, and EPUB. CBZ is the recommended format for best compatibility — it is a ZIP file renamed to .cbz containing image files. Most manga downloads from online sources come in CBZ format. PDF support handles comics distributed as PDFs, though image quality can vary. EPUB support is primarily for digital comics distributed in epub format, not plain text ebooks.

                      How should I organise my manga files for Komga?

                      The recommended structure is: Library Folder / Series Name / Volume 01.cbz, Volume 02.cbz, etc. Komga detects the series name from the folder name and orders volumes by filename. For one-shots: Library Folder / One-Shot Title.cbz (no subdirectory). Avoid deeply nested folders — Komga scans recursively but performs best with a flat two-level structure. Use consistent naming: 'Volume 01' sorts correctly while 'Vol1' and 'Volume 1' mix unpredictably.

                      Can I read comics in the browser without installing anything?

                      Yes. Komga has a built-in web reader accessible from any browser on any device. Open a series, select a volume, and read directly in the browser with controls for page layout (single, double, long strip), reading direction (LTR for western comics, RTL for manga), zoom, and bookmarking. The web reader works on tablets and phones via the browser — no app required. Reading progress is tracked server-side and synced across all devices.

                      How does Komga compare to Kavita?

                      Both are self-hosted comic/manga servers with similar features. Komga has superior Tachiyomi/Mihon integration (native source extension) and slightly better OPDS implementation. Kavita has broader format support (including audiobooks and novels in addition to comics) and a more unified interface for mixed media libraries. If you read exclusively manga and comics on Android via Tachiyomi, Komga is the better choice. If you also read novels and audiobooks in the same server, Kavita handles the mixed library better.

                      Can Komga sync with a Kobo e-reader?

                      Yes, indirectly. Install KOReader on your Kobo (it replaces or supplements the stock firmware). KOReader has an OPDS plugin that connects to Komga's OPDS catalog. Browse your manga collection from the Kobo, download volumes, and read with reading progress synced back to the server. The manga displays optimised for e-ink screens. This setup works best for manga with clean black-and-white artwork — colour artwork and complex backgrounds lose quality on e-ink displays.

                      How do I add metadata like descriptions and author names?

                      Komga reads metadata from ComicInfo.xml files embedded inside CBZ archives. Many manga download tools include these automatically. For existing archives without metadata, use the Komga UI to manually edit series metadata (title, author, description, genres) or use tools like Mylar3 or Komga's own metadata scraping to fetch data from ComicVine, MangaDex, or AniList. Enable automatic metadata fetching in Administration → Settings → Metadata.

                      Can multiple users share one Komga server?

                      Yes. Komga supports multiple user accounts, each with independent reading progress, bookmarks, and history. Create accounts in Administration → Users. You can restrict user access to specific libraries — e.g. give children access only to age-appropriate libraries while keeping adult comics in a separate restricted library. Each user logs in with their own credentials and sees their own progress without affecting others.