110 lines
4.6 KiB
Markdown
110 lines
4.6 KiB
Markdown
---
|
|
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
|