Files
2026-06-09 18:40:21 +02:00

4.6 KiB


title: Komga created: 2026-06-07 updated: 2026-06-07 type: app tags: [catalogue, books, comics, manga, bd, opds, kobo, koreader, kotlin, spring-boot] confidence: high contested: false sources: [https://selfh.st/apps/?tag=Books, https://github.com/gotson/komga]

🦊 Komga

Le serveur de médias par excellence pour les comics, mangas, BDs, magazines et ebooks — REST API, OPDS v1/v2, Kobo et KOReader Sync, le tout sous Spring Boot / Kotlin.

📋 Informations Générales

Champ Valeur
Site web komga.org
GitHub gotson/komga
Licence MIT
Langage Kotlin (66,6%), Vue.js (26,8%)
Étoiles GitHub 6,3k
Dernière MAJ 2026-06-04
Catégorie [[cat-books

📝 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

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

🔄 Alternatives

Open Source

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

📚 Ressources

Pages Liées