Komga Comic Server

beginner

Komga media server for comics and manga with OPDS support.

Overview

Komga is a free and open-source media server specifically designed for comics and manga, developed by Gotson to address the lack of quality comic book management solutions. Built with Spring Boot and Vue.js, Komga provides a modern web interface for organizing, reading, and sharing digital comic collections while supporting industry-standard formats like CBZ, CBR, PDF, and EPUB. The server automatically scans libraries, extracts metadata, and generates thumbnails to create a Netflix-like browsing experience for comic enthusiasts. This Docker deployment creates a self-contained comic server that handles everything from library scanning to user management and reading progress synchronization. Komga's architecture separates the web interface from the underlying file system, allowing multiple users to access the same comic collection with individual reading progress, bookmarks, and preferences. The server includes built-in OPDS (Open Publication Distribution System) support, enabling integration with dedicated e-reader applications and comic reading clients. This setup is ideal for comic collectors, families sharing digital libraries, and anyone wanting to centralize their comic reading experience across multiple devices. Komga's lightweight resource requirements make it perfect for home servers, NAS devices, or cloud deployments, while its comprehensive API enables integration with mobile apps like Tachiyomi for Android and various OPDS-compatible readers for a complete digital comic ecosystem.

Key Features

Automatic comic library scanning with metadata extraction from CBZ, CBR, PDF, and EPUB files
Multi-user support with individual reading progress, bookmarks, and collection management
OPDS v1.2 and v2.0 feeds for compatibility with dedicated comic reader applications
Advanced library organization with series grouping, reading list creation, and collection filtering
Built-in webreader with page-by-page and double-page reading modes plus zoom controls
REST API for integration with third-party applications like Tachiyomi manga reader
Duplicate detection and file integrity checking to maintain clean comic libraries
User access controls with library-level permissions and admin management tools

Common Use Cases

1Home media server for families wanting to share and organize large comic book collections
2Digital comic library management for collectors transitioning from physical to digital formats
3Remote comic access setup for reading collections while traveling or away from home
4Multi-device comic synchronization keeping reading progress consistent across phones, tablets, and computers
5OPDS server deployment for integration with dedicated e-reader devices and comic reading apps
6Small library or community center providing digital comic access to patrons
7Backup and preservation system for valuable or rare comic collections

Prerequisites

Docker and Docker Compose installed on host system
Minimum 512MB RAM available for Komga container operation
Port 25600 available and not in use by other services
Storage space for both comic files and generated thumbnails (expect 10-20% overhead)
Comic files organized in folders and in supported formats (CBZ, CBR, PDF, EPUB)
Basic understanding of file permissions for Docker volume mounting

For development & testing. Review security settings, change default credentials, and test thoroughly before production use. See Terms

docker-compose.yml

1services: 
2  komga: 
3    image: gotson/komga:latest
4    container_name: komga
5    environment: 
6      - TZ=${TZ}
7    volumes: 
8      - komga_config:/config
9      - /path/to/comics:/data
10    ports: 
11      - "25600:25600"
12    restart: unless-stopped
13    networks: 
14      - komga-network
15
16volumes: 
17  komga_config: 
18
19networks: 
20  komga-network: 
21    driver: bridge

.env Template

.env

1# Komga
2TZ=UTC

Usage Notes

1Web UI at http://localhost:25600
2Create admin on first visit
3Supports CBZ, CBR, PDF, EPUB
4OPDS feed for e-readers
5Tachiyomi extension available

Quick Start

terminal

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  komga:
5    image: gotson/komga:latest
6    container_name: komga
7    environment:
8      - TZ=${TZ}
9    volumes:
10      - komga_config:/config
11      - /path/to/comics:/data
12    ports:
13      - "25600:25600"
14    restart: unless-stopped
15    networks:
16      - komga-network
17
18volumes:
19  komga_config:
20
21networks:
22  komga-network:
23    driver: bridge
24EOF
25
26# 2. Create the .env file
27cat > .env << 'EOF'
28# Komga
29TZ=UTC
30EOF
31
32# 3. Start the services
33docker compose up -d
34
35# 4. View logs
36docker compose logs -f

One-Liner

Run this command to download and set up the recipe in one step:

terminal

1curl -fsSL https://docker.recipes/api/recipes/komga-comics/run | bash

Troubleshooting

Comics not appearing in library: Check file permissions on mounted volume and ensure Komga container can read comic files
Thumbnails not generating: Verify sufficient disk space in config volume and restart container to rebuild thumbnail cache
OPDS feed not working in reader apps: Confirm port 25600 is accessible and use full URL format http://server-ip:25600/opds/v1.2/catalog
Reading progress not syncing: Clear browser cache and ensure user is properly logged in, check for multiple browser sessions
High memory usage during scanning: Limit concurrent scanning in settings or increase container memory allocation for large libraries
Tachiyomi extension connection failed: Verify server URL format includes http:// prefix and port number, check network connectivity

Community Notes

Loading notes...

Download Recipe Kit

Get all files in a ready-to-deploy package

Includes docker-compose.yml, .env template, README, and license

Components

komga

Related Recipes

Ad Space

Shortcuts: C CopyF FavoriteD Download