Héberger Komga sur un VPS infogéré, c'est lire vos bandes dessinées, vos mangas et vos livres numériques depuis une machine à vous, que nos équipes tiennent à jour et supervisent jour et nuit. Komga est un serveur de médias libre, sous licence MIT. Ce guide suit sa documentation officielle : la mémoire et le stockage à prévoir, l'installation avec Docker Compose, le premier compte, la configuration, HTTPS, les bibliothèques, la lecture par OPDS, Kobo et KOReader, les sauvegardes et les mises à jour.
Par Simon Vasconcelos Lee
Publié le 22 novembre 2026Lecture : 15 minutes
/data ; la base, l'index et les journaux vivent dans /config, sur un disque local.gotson/komga, le port 25600 publié en local derrière un proxy inverse en HTTPS, et un utilisateur propriétaire des deux dossiers./config hors du serveur, gardez une copie de vos livres, et mettez à jour avec docker compose pull.Komga est un serveur de médias pour vos bandes dessinées, vos mangas, vos BD, vos magazines et vos livres numériques. Vous lui indiquez les dossiers où sont rangés vos fichiers, il les organise en bibliothèques, en séries et en livres, puis les sert à un navigateur ou à une application de lecture. Il tourne partout où Java ou Docker tourne.
Komga est publié sous licence MIT, au nom de Gauthier Roebroeck. Elle accorde gratuitement le droit d'utiliser, de copier, de modifier, de fusionner, de publier, de distribuer, de sous-licencier et de vendre des copies du logiciel. Vous pouvez donc le faire tourner pour vous, votre famille, votre association ou votre entreprise, sans licence à acheter.
La seule condition est de garder la notice de copyright et le texte de la licence dans toute copie ou partie substantielle du logiciel. Le texte fournit le logiciel « tel quel », sans garantie.
La documentation ne fixe pas de configuration minimale. Elle donne en revanche ce qui compte pour dimensionner le serveur : la mémoire de la machine virtuelle Java, les tâches qui sollicitent le processeur, et surtout la place de vos fichiers.
OutOfMemoryException dans les journaux. La limite se relève alors avec la variable JAVA_TOOL_OPTIONS, présentée plus bas.Le processeur travaille surtout pendant les scans et les analyses des bibliothèques. Pour chacune, la documentation prévient que le calcul des empreintes de fichiers, des empreintes de pages et des empreintes pour KOReader, comme l'analyse des dimensions des pages, peut demander beaucoup de ressources sur une grande bibliothèque. Le nombre de fils dédiés aux tâches de fond se règle dans « Server Settings ».
C'est le poste qui pèse le plus, et il se mesure chez vous : le volume de votre collection, plus la place des livres que vous comptez y ajouter. Komga lit vos fichiers là où ils sont et ne les recopie pas. Quelques points de la documentation changent le calcul :
/data pour les livres et les imports : la documentation demande d'y placer vos bibliothèques et votre dossier d'import, pour que l'import crée des liens physiques au lieu de copier. Hors du même système de fichiers, chaque import occupe la place d'une copie./config garde la base de données principale, avec les miniatures générées pour chaque livre, la base des tâches, celle des sessions, l'index de recherche et les journaux, que la configuration par défaut garde 7 jours et plafonne à 1 Go. Il grandit avec la taille de vos bibliothèques./config : les bases SQLite ne doivent jamais être sur un partage réseau comme CIFS ou NFS. Komga le vérifie au démarrage, et s'arrête si ce n'est pas le cas.Sur un VPS infogéré, décrivez-nous votre collection, son volume, son rythme de croissance et le nombre de lecteurs, et nous vous recommandons la taille qui convient.
La documentation publie l'image gotson/komga sur Docker Hub et sur ghcr.io, pour les processeurs amd64, arm64 et arm. Sur un serveur où Docker est installé, créez un dossier pour Komga, avec ses deux sous-dossiers, et relevez votre identifiant d'utilisateur :
mkdir -p ~/komga/config ~/komga/data/import
cd ~/komga
id
Placez-y ce compose.yaml, tiré de l'exemple de la documentation. Remplacez 1000:1000 par les valeurs uid et gid affichées par id, et TZ par votre fuseau horaire :
services:
komga:
image: gotson/komga:1.x
container_name: komga
volumes:
- type: bind
source: ./config
target: /config
- type: bind
source: ./data
target: /data
ports:
- "127.0.0.1:25600:25600"
user: "1000:1000"
environment:
- TZ=Europe/London
restart: unless-stopped
docker compose up -d
docker logs -f komga
127.0.0.1 : c'est l'écart principal avec l'exemple de la documentation, qui le publie sur toutes les adresses. La documentation recommande fortement HTTPS dès que Komga s'ouvre hors du réseau local, car il utilise l'authentification HTTP basique. L'interface s'atteint alors par le seul proxy inverse.user. La documentation demande que les dossiers montés appartiennent à ce même utilisateur : les problèmes de permissions disparaissent alors./config garde la base de données et la configuration de Komga, sur un disque local./data contient vos livres et votre dossier d'import. Chaque bibliothèque y aura son propre sous-dossier.1.x suit la dernière version 1 publiée ; 1.30.1 fixe une version. La documentation réserve latest au dernier commit.version de l'exemple de la documentation est omise : Docker Compose la tient aujourd'hui pour obsolète et l'ignore.L'autre voie de la documentation pour un serveur Linux est le fichier jar de chaque version, publié sur GitHub. Il demande Java 17 ou plus récent, et garde sa configuration dans ~/.komga :
java -version
java -jar komga-1.30.1.jar
Au premier accès, Komga demande de créer un compte : une adresse e-mail et un mot de passe. Ce premier compte reçoit tous les rôles, administration comprise, et « réclame » le serveur. Tant qu'il n'existe pas, ce formulaire répond à quiconque atteint la page : créez-le avant d'ouvrir le serveur au public, par un tunnel SSH. Le port 25600 du serveur apparaît alors sur votre poste, à l'adresse http://localhost:25600. Ajoutez -p et le port SSH affiché dans votre espace client.
ssh -L 25600:127.0.0.1:25600 utilisateur@komga.example.com
Les comptes suivants, c'est l'administrateur qui les crée, dans « Server Settings », « Users », avec le bouton +. Chaque compte reçoit les rôles dont il a besoin :
| Rôle | Ce qu’il permet |
|---|---|
| Administrator | Gérer les bibliothèques, les utilisateurs et les collections, modifier les métadonnées, lancer les scans, les analyses et les rafraîchissements |
| Page Streaming | Lire page par page, dans la liseuse web par exemple |
| File Download | Télécharger le fichier d’un livre |
| Kobo Sync | Synchroniser une liseuse Kobo, avec le rôle File Download |
| KOReader Sync | Synchroniser sa progression avec KOReader |
Supprimer un utilisateur efface toute sa progression de lecture, sans retour possible : une copie de /config juste avant vous garde la main.
La documentation ajoute la commande au compose.yaml, sous le service komga ; Komga applique le changement, puis démarre normalement. Relancez le service, puis retirez la ligne et relancez-le une seconde fois :
command: --newpassword=NouveauMotDePasse --reset=admin@example.org
docker compose up -d
La commande --list-users, sur le même modèle, affiche dans les journaux la liste des comptes.
Komga a des valeurs par défaut pour chaque réglage : la configuration ne sert qu'à changer son comportement. Elle se fait par des variables d'environnement, le plus simple avec Docker Compose, ou par un fichier application.yml à créer dans le dossier /config, où l'image Docker le charge. Pour passer du nom d'une propriété à celui d'une variable, remplacez les points par des tirets bas, retirez les tirets et passez en majuscules.
| Variable | Propriété | Par défaut | Son rôle |
|---|---|---|---|
SERVER_PORT | server.port | 25600 | Le port de l’API et de l’interface web |
SERVER_SERVLET_CONTEXTPATH | server.servlet.context-path | / | L’URL de base, pour servir Komga dans un sous-dossier |
SPRING_SESSION_TIMEOUT | spring.session.timeout | 7 jours | La durée d’une session inactive, par exemple 14d ou 24h |
KOMGA_CORS_ALLOWEDORIGINS | komga.cors.allowed-origins | Aucune | Les origines autorisées pour CORS |
LOGGING_LEVEL_ORG_GOTSON_KOMGA | logging.level.org.gotson.komga | Non défini | DEBUG pour des journaux détaillés |
Le port et l'URL de base se règlent aussi dans « Server Settings », et ce réglage l'emporte alors sur la configuration. Pour la mémoire de Java, ajoutez la variable JAVA_TOOL_OPTIONS à la section environment. L'exemple de la documentation fixe un maximum de 4 Go :
- JAVA_TOOL_OPTIONS=-Xmx4g
L'exemple de application.yml de la documentation commence par le chemin de la base. Avec Docker, gardez-le sur /config/database.sqlite, sa valeur par défaut : ailleurs, la base serait créée dans le conteneur et perdue à sa recréation. Ne gardez de l'exemple que les lignes dont vous avez besoin.
La documentation recommande de placer devant Komga un proxy inverse qui obtient un certificat valide, et suggère Caddy, qui génère seul ses certificats Let's Encrypt. Le proxy doit poser trois en-têtes, pour que Komga connaisse l'adresse publique et le protocole de chaque requête :
X-Forwarded-For, posé ou complété ;X-Forwarded-Proto ;X-Forwarded-Host.Sur un sous-domaine, sans URL de base dans Komga, Caddy pose ces en-têtes lui-même :
komga.example.com {
reverse_proxy 127.0.0.1:25600
}
Dans un sous-dossier, réglez d'abord l'URL de base de Komga sur /komga, dans « Server Settings » ou par SERVER_SERVLET_CONTEXTPATH, puis :
example.com {
reverse_proxy /komga/* 127.0.0.1:25600
}
L'exemple Nginx de la documentation transmet aussi les connexions WebSocket. Ajoutez ce bloc map dans la section http de /etc/nginx/nginx.conf :
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
Ce bloc de site reprend les réglages de l'exemple de la documentation, sur le port 80 pour laisser Certbot poser HTTPS. La ligne X-Forwarded-Host y est ajoutée, puisque la liste des en-têtes de la documentation la demande :
server {
listen 80;
listen [::]:80;
server_name komga.example.com;
client_max_body_size 20000m;
location / {
proxy_pass http://127.0.0.1:25600;
proxy_http_version 1.1;
proxy_redirect off;
proxy_buffering off;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Host $host;
}
}
sudo nginx -t
sudo certbot --nginx
L'exemple complet de la documentation montre la version finale : le port 80 redirigé vers HTTPS, et le bloc en 443 avec ses chemins de certificat.
Une bibliothèque est un groupe de livres, rangé sous un dossier racine. Komga crée une série pour chaque sous-dossier, à toute profondeur, et un livre pour chaque fichier, placé dans la série de son dossier parent. Les métadonnées des fichiers EPUB et des fichiers ComicInfo.xml des archives l'emportent sur les noms de dossiers et de fichiers.
~/komga/data par bibliothèque, par SFTP ou avec rsync./data/mangas, puis cliquez sur « Add ».rsync -av mangas/ utilisateur@komga.example.com:komga/data/mangas/
/data/mangas et /data/comics cohabitent ; /data et /data/mangas, non.#recycle.Un livre dont le fichier disparaît passe dans la corbeille, avec l'indication « Unavailable », au lieu d'être supprimé : ses métadonnées, sa progression de lecture et ses listes reviennent si le fichier réapparaît à sa place. Vous pouvez donc renommer et déplacer vos fichiers sans rien perdre. La corbeille se vide à la main, ou après chaque scan si vous activez l'option, qui supprime alors aussitôt.
L'écran « Import », « Books » range dans vos séries des fichiers venus d'un autre dossier du serveur, /data/import par exemple. Pour chaque fichier, vous choisissez la série de destination, le numéro et le nom ; un numéro déjà pris propose de remplacer le livre existant, en comparant les deux. Komga déplace les fichiers, ou les lie par un lien physique quand le système de fichiers le permet, et les copie sinon.
Changer le dossier racine d'une bibliothèque pour un chemin sans rapport avec l'ancien efface ses séries, ses livres et sa progression de lecture. La FAQ décrit la marche à suivre pour la déplacer : empreintes de fichiers actives, vidage automatique de la corbeille désactivé, puis scan avant le déplacement.
La liseuse web s'ouvre dans le navigateur, à l'adresse du serveur. Pour une application ou une liseuse, Komga offre trois portes, toutes à servir en HTTPS.
Komga fonctionne avec toute application OPDS, en version 1 ou 2. Donnez à l'application l'une de ces adresses, puis l'adresse e-mail et le mot de passe de votre compte Komga :
https://komga.example.com/opds/v2/catalog
https://komga.example.com/opds/v1.2/catalog
Le catalogue en version 1.2 ajoute la recherche par série, par OpenSearch, et la lecture page par page sans téléchargement, par l'extension OPDS PSE. La documentation tient une liste des applications testées, sur Android, iOS et ailleurs, avec ce que chacune prend en charge.
Votre liseuse Kobo se synchronise avec Komga au lieu des serveurs officiels de Kobo. Les livres EPUB de toutes les bibliothèques y arrivent avec leurs métadonnées et leur couverture, convertis en KEPUB à la volée par Kepubify, inclus dans l'image Docker. La progression de lecture se synchronise dans les deux sens.
.kobo/Kobo/Kobo eReader.conf, en affichant les fichiers cachés.[OneStoreServices], remplacez la ligne api_endpoint par l’adresse de votre serveur suivie de votre clé.api_endpoint=https://komga.example.com/kobo/VOTRE_CLE_API
api_endpoint, 443 pour une adresse en HTTPS.KOReader lit Komga par OPDS, et synchronise sa progression de lecture par le serveur de synchronisation de Komga :
https://komga.example.com/koreader.Tout ce que Komga sait de vos livres vit dans /config ; vos livres, eux, restent dans /data. Voici le contenu de /config avec la configuration par défaut :
| Élément | Ce qu’il garde |
|---|---|
database.sqlite | La base principale : bibliothèques, séries, livres, métadonnées, utilisateurs, progression de lecture, collections, listes de lecture et miniatures générées |
tasks.sqlite | Les tâches de fond en attente |
sessions.sqlite | Les sessions de connexion, gardées en base par défaut depuis la version 1.30.0 |
lucene/ | L’index de la recherche |
fonts/ | Les polices |
logs/ | Les journaux, dont komga.log |
application.yml | Votre configuration, si vous l’avez créée |
Les bases SQLite se copient Komga arrêté, pour une copie cohérente. Depuis le dossier du compose.yaml :
docker compose stop
tar -czf komga-config-$(date +%F).tar.gz config
docker compose start
Envoyez cette archive hors du serveur, au rythme de vos ajouts et de vos lectures. Gardez aussi une copie de vos livres, avec les couvertures que vous rangez à côté des fichiers : c'est le volume le plus lourd, mais il change peu, et rsync n'en renvoie que les nouveautés. Posées sur le disque du serveur, ces archives entrent aussi dans ses sauvegardes de nuit.
Pour restaurer, arrêtez Komga, remplacez le dossier config par celui de l'archive, vérifiez qu'il appartient toujours à l'utilisateur du compose.yaml, puis redémarrez.
Avec Docker Compose, la documentation donne ces commandes, depuis le dossier du compose.yaml. Le dossier /config, monté depuis le serveur, garde vos réglages :
docker compose pull
docker compose up -d
docker image prune
/config juste avant chaque mise à jour.jar, arrêtez Komga, puis démarrez-le avec le jar de la nouvelle version.L'auto-hébergement demande de tenir le serveur en plus de l'application. Sur un VPS infogéré, nos équipes prennent le serveur en main et suivent votre instance de manière proactive ; Komga reste votre logiciel, avec ses réglages et vos livres.
| Sujet | Nos équipes | Vous |
|---|---|---|
| Le serveur | Mises à jour du système et de la sécurité, interventions sur le serveur comprises | Le moment qui convient à votre activité |
| La supervision | Serveur suivi 24 h/24 et 7 j/7, avec intervention sans attendre votre appel | La lecture des journaux de votre instance |
| Komga | Suivi proactif : erreurs, lenteurs, mémoire et espace disque repérés, correction recommandée | Son installation, ses mises à jour et ses réglages, que vous appliquez, vous ou votre assistant IA |
| Les bibliothèques et les lecteurs | Le serveur qui les porte, surveillé et sauvegardé | Les bibliothèques, les comptes, les rôles et les clés d’API |
| Les sauvegardes | Chaque nuit, chiffrées et gardées hors de la machine ; restauration comprise | Les copies propres à Komga, et la demande de restauration, quand vous en avez besoin |
| La migration | Votre serveur actuel migré, offert | Le moment de la bascule |
Si vous préférez que nos équipes interviennent dans l'application elle-même, cette prestation se facture à l'heure ou au forfait, avec un chiffrage communiqué avant l'intervention.
Avec un VPS infogéré Simafri, nos équipes tiennent à jour le serveur de votre instance Komga, le surveillent jour et nuit et interviennent sans attendre votre appel ; elles suivent aussi votre instance de manière proactive et vous recommandent les corrections utiles, que vous appliquez, vous ou votre assistant IA. Les sauvegardes sont chiffrées chaque nuit et gardées hors de la machine, leur restauration est comprise, et la migration de votre serveur actuel est offerte.
Oui. Komga est sous licence MIT : vous pouvez l'utiliser, le modifier et le redistribuer en entreprise sans licence à acheter, en gardant sa notice de copyright. Reste le coût du serveur qui le fait tourner.
La documentation ne fixe pas de minimum. Java limite par défaut la mémoire de Komga, le plus souvent vers 1 Go. Si les journaux montrent des erreurs OutOfMemoryException, relevez la limite avec JAVA_TOOL_OPTIONS, par exemple -Xmx4g pour 4 Go.
Créez un compose.yaml avec l'image gotson/komga, le port 25600 publié sur 127.0.0.1, un dossier config monté sur /config, un dossier data monté sur /data, et un utilisateur propriétaire des deux, puis lancez docker compose up -d. Placez ensuite un proxy inverse en HTTPS devant le port 25600.
Au premier accès, Komga demande une adresse e-mail et un mot de passe : ce premier compte reçoit tous les rôles. Créez-le par un tunnel SSH avant d'ouvrir le serveur au public, puis créez les autres comptes dans Server Settings, Users.
L'adresse de votre serveur suivie de /opds/v2/catalog pour OPDS 2, ou de /opds/v1.2/catalog pour OPDS 1.2, avec l'adresse e-mail et le mot de passe de votre compte Komga.
Donnez au compte les rôles Kobo Sync et File Download, générez une clé d'API dans Account Settings, puis remplacez la ligne api_endpoint du fichier Kobo eReader.conf par https://votre-serveur/kobo/votre-cle. Seuls les livres EPUB sont synchronisés.
Arrêtez Komga, archivez le dossier config, redémarrez, et envoyez l'archive hors du serveur. Gardez aussi une copie de vos livres. Faites une copie juste avant chaque mise à jour.
Un VPS infogéré couvre le serveur : système, sécurité, supervision et sauvegardes. Nos équipes suivent aussi votre instance de manière proactive et vous recommandent les corrections utiles, que vous appliquez. Une intervention dans l'application se facture à l'heure ou au forfait.
Simafri
Parlons de votre projet
Dites-nous en deux mots ce qu'il vous faut : on revient vers vous rapidement.
Merci ! Votre demande a bien été envoyée. Nous vous répondrons rapidement.
Vous préférez l'email ? Écrivez-nous à support@simafri.com.