Komga

Komga est un media server moderne écrit en Kotlin / Spring Boot 3.5 avec un frontend Vue.js. Pensé à l'origine pour les comics / mangas / BDs, il accepte aussi les magazines et les ebooks (EPUB, PDF, CBZ, CBR, RAR4 solide). L'organisation est hiérarchique : bibliothèques → séries → livres → pages, a

Description

Komga est un media server moderne écrit en Kotlin / Spring Boot 3.5 avec un frontend Vue.js. Pensé à l'origine pour les comics / mangas / BDs, il accepte aussi les magazines et les ebooks (EPUB, PDF, CBZ, CBR, RAR4 solide). L'organisation est hiérarchique : bibliothèques → séries → livres → pages, avec une UI responsive adaptée à tous les écrans.

L'OPDS v1 et v2 est une brique de première classe (Kavita, Stump et d'autres prennent Komga en référence). Komga supporte aussi la Kobo Sync et la KOReader Sync, ce qui en fait un choix évident pour les lecteurs de Kobo et les utilisateurs de KOReader sur liseuses. Les listes de lecture, collections, étiquettes, restrictions par âge et par label, et la détection de doublons (au niveau fichier et page) couvrent l'essentiel des usages avancés.

L'API REST est riche et documentée, ce qui permet d'automatiser imports, renommages, scans, et de brancher des scripts ou des frontends alternatifs. C'est la référence 2026 pour qui veut un serveur solide, multi-format, avec un webreader natif et une vraie philosophie « library management ».

Installation

Option 1 : Docker Compose (recommandé)

# docker-compose.yml
services:
  komga:
    image: gotson/komga:latest
    container_name: komga
    environment:
      - TZ=Europe/Paris
    volumes:
      - ./config:/config
      - ./data:/data
      - ./comics:/comics   # vos bibliothèques comics / BD
      - ./ebooks:/ebooks   # vos bibliothèques epub / pdf
    ports:
      - 25600:8080
    restart: unless-stopped

L'UI est disponible sur http://localhost:25600, l'API sur /api/v1/..., l'OPDS sur /opds/v1.2/... et /opds/v2/....

Option 2 : Binaire / Java

Komga tourne aussi en JVM (Java 21+), pratique pour les setups non-Dockerisés.

Configuration

Bibliothèques : ajoutez des dossiers montés ; Komga scanne récursivement et génère des series à partir de la structure.
Webreader : plusieurs modes de lecture, mémo de progression, et annotations.
Kobo / KOReader Sync : activable depuis l'admin, configurer l'URL publique et l'API key par utilisateur.
API : générez des tokens pour vos scripts / intégration avec [[app-shelfmark]] ou clients OPDS tiers.
Restriction par âge et label : idéal pour un foyer avec enfants.
Reverse proxy : simple à exposer, gère très bien HTTPS.

Alternatives

Open Source

[[app-kavita]] — Concurrent direct, plus EPUB-centric
[[app-stump]] — Serveur Rust jeune et léger
[[app-calibre-web]] — Plutôt ebooks Calibre
[[app-grimmory]] — Plateforme unifiée livres + comics

Propriétaires

YACReader (serveur, mais pas vraiment self-hosted cloud)
Marvel Unlimited
ComiXology (rapatrié dans Kindle)

Sécurité

✅ Authentification locale + OIDC (Authentik, Keycloak)
✅ Permissions par bibliothèque et par utilisateur
✅ API REST avec tokens révocables
⚠️ HTTPS obligatoire en cas d'exposition publique
⚠️ Sauvegardez ./config (SQLite) et les dossiers médias
⚠️ Mettez à jour régulièrement : Spring Boot 3.5 corrige plusieurs CVE