Initial vault setup

2026-06-09 18:40:21 +02:00
commit bda02d587f
3692 changed files with 402457 additions and 0 deletions
@@ -0,0 +1,109 @@
+---
+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