---
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](https://komga.org/) |
| **GitHub** | [gotson/komga](https://github.com/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|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é)

```yaml
# 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
- [[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

## 📚 Ressources

- [selfh.st — Books](https://selfh.st/apps/?tag=Books)
- [Site officiel](https://komga.org/)
- [GitHub gotson/komga](https://github.com/gotson/komga)
- [Documentation](https://komga.org/docs/category/installation)
- [Discord](https://discord.gg/TdRpkDu)

## Pages Liées

- [[cat-books]] — Vue d'ensemble de la catégorie Books
- [[app-kavita]] — Concurrent principal
- [[app-stump]] — Alternative Rust jeune
- [[app-shelfmark]] — Téléchargeur qui peut pousser vers Komga
- [[recettes-docker-compose]] — Templates Docker
