Héberger Komga sur un VPS géré : vos BD et mangas sur votre serveur

Héberger Komga sur un VPS gé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.

Simon Vasconcelos Lee Par Publié le 22 novembre 2026Lecture : 15 minutes

Tous les guides

L'essentiel

  1. La licence MIT permet d'utiliser, de modifier et de redistribuer Komga librement, en entreprise comme ailleurs, en gardant sa notice de copyright.
  2. Le stockage se dimensionne sur votre collection, rangée dans /data ; la base, l'index et les journaux vivent dans /config, sur un disque local.
  3. Installez-le avec Docker Compose : l'image gotson/komga, le port 25600 publié en local derrière un mandataire inverse en HTTPS, et un utilisateur propriétaire des deux dossiers.
  4. Le premier compte créé devient l'administrateur : créez-le par un tunnel SSH avant d'ouvrir le serveur au public.
  5. Arrêtez Komga, copiez le dossier /config hors du serveur, gardez une copie de vos livres, et mettez à jour avec docker compose pull.

Ce que fait Komga

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.

Ce que permet la licence MIT

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.

Mémoire, processeur et stockage : dimensionner le serveur

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.

La mémoire de Java

Le processeur

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 ».

Le stockage de vos livres

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 :

Sur un VPS gé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.

L'installation avec Docker Compose

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 :

Terminal
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 :

compose.yaml
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
Terminal
docker compose up -d
docker logs -f komga

Sans Docker : le fichier jar

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 :

Terminal
java -version
java -jar komga-1.30.1.jar

Le premier compte et les utilisateurs

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.

Terminal, sur votre poste
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ôleCe qu'il permet
AdministratorGérer les bibliothèques, les utilisateurs et les collections, modifier les métadonnées, lancer les scans, les analyses et les rafraîchissements
Page StreamingLire page par page, dans la liseuse web par exemple
File DownloadTélécharger le fichier d'un livre
Kobo SyncSynchroniser une liseuse Kobo, avec le rôle File Download
KOReader SyncSynchroniser 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.

Remplacer un mot de passe en ligne de commande

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 :

compose.yaml, sous le service komga
    command: --newpassword=NouveauMotDePasse --reset=admin@example.org
Terminal
docker compose up -d

La commande --list-users, sur le même modèle, affiche dans les journaux la liste des comptes.

La configuration : variables ou application.yml

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.

VariablePropriétéPar défautSon rôle
SERVER_PORTserver.port25600Le port de l'API et de l'interface web
SERVER_SERVLET_CONTEXTPATHserver.servlet.context-path/L'URL de base, pour servir Komga dans un sous-dossier
SPRING_SESSION_TIMEOUTspring.session.timeout7 joursLa durée d'une session inactive, par exemple 14d ou 24h
KOMGA_CORS_ALLOWEDORIGINSkomga.cors.allowed-originsAucuneLes origines autorisées pour CORS
LOGGING_LEVEL_ORG_GOTSON_KOMGAlogging.level.org.gotson.komgaNon définiDEBUG 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 :

compose.yaml, dans environment
      - 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.

HTTPS et le mandataire inverse

La documentation recommande de placer devant Komga un mandataire inverse qui obtient un certificat valide, et suggère Caddy, qui génère seul ses certificats Let's Encrypt. Le mandataire doit ajouter trois en-têtes, pour que Komga connaisse l'adresse publique et le protocole de chaque requête :

Avec Caddy

Sur un sous-domaine, sans URL de base dans Komga, Caddy ajoute ces en-têtes lui-même :

Caddyfile
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 :

Caddyfile
example.com {
    reverse_proxy /komga/* 127.0.0.1:25600
}

Avec Nginx

L'exemple Nginx de la documentation transmet aussi les connexions WebSocket. Ajoutez ce bloc map dans la section http de /etc/nginx/nginx.conf :

nginx.conf, dans http
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 installer HTTPS. La ligne X-Forwarded-Host y est ajoutée, puisque la liste des en-têtes de la documentation la demande :

Bloc Nginx
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;
    }
}
Terminal
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.

Les bibliothèques, les scans et les imports

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.

  1. Déposez vos fichiers sur le serveur, dans un sous-dossier de ~/komga/data par bibliothèque, par SFTP ou avec rsync.
  2. Dans l'interface, cliquez sur + à côté de « Libraries ».
  3. Donnez un nom à la bibliothèque, choisissez son dossier racine avec « Browse », par exemple /data/mangas, puis cliquez sur « Add ».
Terminal, sur votre poste
rsync -av mangas/ utilisateur@komga.example.com:komga/data/mangas/

La corbeille

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'import de livres

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.

Lire partout : OPDS, Kobo et KOReader

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.

OPDS

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 :

Adresses OPDS
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.

La synchronisation Kobo

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.

  1. Donnez au compte les rôles Kobo Sync et File Download.
  2. Générez une clé d'API dans la page de votre compte, « Account Settings », et notez-la : elle ne s'affiche qu'une fois. Prenez une clé par liseuse.
  3. Branchez la Kobo à votre ordinateur et ouvrez le fichier .kobo/Kobo/Kobo eReader.conf, en affichant les fichiers cachés.
  4. Dans le groupe [OneStoreServices], remplacez la ligne api_endpoint par l'adresse de votre serveur suivie de votre clé.
Kobo eReader.conf
api_endpoint=https://komga.example.com/kobo/VOTRE_CLE_API

La synchronisation KOReader

KOReader lit Komga par OPDS, et synchronise sa progression de lecture par le serveur de synchronisation de Komga :

  1. Donnez au compte le rôle KOReader Sync, et activez les empreintes de fichiers pour KOReader dans les options de la bibliothèque.
  2. Générez une clé d'API dans la page de votre compte.
  3. Dans KOReader, livre ouvert, allez dans « Progress sync », puis « Custom sync server », et saisissez https://komga.example.com/koreader.
  4. Dans « Register / Login », saisissez la clé d'API comme nom d'utilisateur, et une valeur quelconque comme mot de passe, que Komga n'utilise pas.
  5. Dans « Document matching method », choisissez « Binary ».

Les sauvegardes

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émentCe qu'il garde
database.sqliteLa 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.sqliteLes tâches de fond en attente
sessions.sqliteLes 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.ymlVotre 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 :

Terminal, dans ~/komga
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.

Les mises à jour

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 :

Terminal
docker compose pull
docker compose up -d
docker image prune

Qui fait quoi sur un VPS géré

L'auto-hébergement demande de tenir le serveur en plus de l'application. Sur un VPS gé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.

SujetNos équipesVous
Le serveurMises à jour du système et de la sécurité, interventions sur le serveur comprisesLe moment qui convient à votre activité
La supervisionServeur suivi 24 h/24 et 7 j/7, avec intervention sans attendre votre appelLa lecture des journaux de votre instance
KomgaSuivi proactif : erreurs, lenteurs, mémoire et espace disque repérés, correction recommandéeSon installation, ses mises à jour et ses réglages, que vous appliquez, vous ou votre assistant IA
Les bibliothèques et les lecteursLe serveur qui les porte, surveillé et sauvegardéLes bibliothèques, les comptes, les rôles et les clés d'API
Les sauvegardesChaque nuit, chiffrées et gardées hors de la machine ; restauration compriseLes copies propres à Komga, et la demande de restauration, quand vous en avez besoin
La migrationVotre serveur actuel migré, offertLe 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.

Komga, sur un serveur tenu pour vous

Avec un VPS gé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.

Découvrir les VPS gérés

Questions fréquentes

Komga est-il gratuit pour une entreprise ?

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.

De combien de mémoire Komga a-t-il besoin ?

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.

Comment installer Komga avec Docker Compose ?

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 mandataire inverse en HTTPS devant le port 25600.

Comment créer le compte administrateur de Komga ?

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.

Quelle adresse OPDS donner à mon application de lecture ?

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.

Comment synchroniser une liseuse Kobo avec 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.

Comment sauvegarder Komga ?

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 géré couvre-t-il Komga ?

Un VPS gé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.

Sources et documentation officielle

Contactez-nous