Komga hosten op een Managed VPS: uw strips en manga op uw eigen server

Komga hosten op een Managed VPS betekent dat u uw strips, manga en e-books leest vanaf een machine die van u is, en die ons team bijwerkt en dag en nacht in de gaten houdt. Komga is een mediaserver en vrije software onder de MIT-licentie. Deze gids volgt de officiële documentatie: het geheugen en de opslag waarmee u rekent, de installatie met Docker Compose, het eerste account, de configuratie, HTTPS, de bibliotheken, lezen via OPDS, Kobo en KOReader, back-ups en updates.

Simon Vasconcelos Lee Door Gepubliceerd op 22 november 2026Leestijd: 14 minuten

Alle gidsen

In het kort

  1. Dankzij de MIT-licentie gebruikt, wijzigt en verspreidt u Komga vrij, in een bedrijf of elders, op voorwaarde dat u de copyrightvermelding behoudt.
  2. De opslag stemt u af op uw collectie, die in /data staat; de database, de index en de logboeken staan in /config, op een lokale schijf.
  3. Installeer het met Docker Compose: de image gotson/komga, poort 25600 lokaal gepubliceerd achter een reverse proxy met HTTPS, en een gebruiker die eigenaar is van beide mappen.
  4. Het eerste aangemaakte account wordt beheerder: maak het aan via een SSH-tunnel voordat u de server openstelt voor het publiek.
  5. Stop Komga, kopieer de map /config buiten de server, bewaar een kopie van uw boeken, en werk bij met docker compose pull.

Wat Komga doet

Komga is een mediaserver voor uw comics, manga, Franco-Belgische strips, tijdschriften en e-books. U wijst het de mappen aan waarin uw bestanden staan, het ordent ze in bibliotheken, series en boeken, en serveert ze daarna aan een browser of een leesapp. Het draait overal waar Java of Docker draait.

Wat de MIT-licentie toestaat

Komga wordt uitgebracht onder de MIT-licentie, op naam van Gauthier Roebroeck. Die verleent kosteloos het recht om kopieën van de software te gebruiken, te kopiëren, te wijzigen, samen te voegen, te publiceren, te verspreiden, in sublicentie te geven en te verkopen. U kunt het dus draaien voor uzelf, uw gezin, uw vereniging of uw bedrijf, zonder een licentie te kopen.

De enige voorwaarde is dat u de copyrightvermelding en de licentietekst behoudt in alle kopieën of wezenlijke delen van de software. De tekst levert de software “zoals hij is”, zonder garantie.

Geheugen, CPU en opslag: de server dimensioneren

De documentatie legt geen minimale configuratie vast. Wel geeft ze wat telt bij het dimensioneren van de server: het geheugen van de Java virtual machine, de taken die de CPU belasten, en vooral de ruimte die uw bestanden innemen.

Het Java-geheugen

De CPU

De CPU werkt vooral tijdens het scannen en analyseren van de bibliotheken. Voor elke bibliotheek waarschuwt de documentatie dat het berekenen van bestandshashes, paginahashes en KOReader-hashes, net als het analyseren van de afmetingen van pagina's, bij een grote bibliotheek veel middelen kan vragen. Het aantal threads voor achtergrondtaken stelt u in onder “Server Settings”.

De opslag voor uw boeken

Dit is de grootste post, en u meet hem zelf: de omvang van uw collectie, plus ruimte voor de boeken die u wilt toevoegen. Komga leest uw bestanden waar ze staan en kopieert ze niet. Een paar punten uit de documentatie veranderen de berekening:

Vertel ons op een managed VPS over uw collectie, haar omvang, hoe snel ze groeit en hoeveel lezers u hebt, en wij raden u de juiste omvang aan.

Installeren met Docker Compose

De documentatie publiceert de image gotson/komga op Docker Hub en op ghcr.io, voor processors amd64, arm64 en arm. Maak op een server met Docker een map voor Komga met de twee submappen, en noteer uw gebruikers-ID:

Terminal
mkdir -p ~/komga/config ~/komga/data/import
cd ~/komga
id

Zet daarin deze compose.yaml, overgenomen uit het voorbeeld van de documentatie. Vervang 1000:1000 door de waarden uid en gid die id toont, en TZ door uw tijdzone:

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

Zonder Docker: het jar-bestand

De andere route van de documentatie voor een Linux-server is het jar-bestand van elke release, gepubliceerd op GitHub. Het vraagt Java 17 of hoger, en bewaart zijn configuratie in ~/.komga:

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

Het eerste account en de gebruikers

Bij het eerste bezoek vraagt Komga u een account aan te maken: een e-mailadres en een wachtwoord. Dat eerste account krijgt alle rollen, beheer inbegrepen, en “claimt” de server. Zolang het niet bestaat, antwoordt dit formulier iedereen die de pagina bereikt: maak het aan voordat u de server openstelt voor het publiek, via een SSH-tunnel. Poort 25600 van de server verschijnt dan op uw computer, op http://localhost:25600. Voeg -p toe en de SSH-poort die in uw klantenzone staat.

Terminal, op uw computer
ssh -L 25600:127.0.0.1:25600 user@komga.example.com

Verdere accounts maakt de beheerder aan, onder “Server Settings”, “Users”, met de knop +. Elk account krijgt de rollen die het nodig heeft:

RolWat hij toestaat
AdministratorBibliotheken, gebruikers en collecties beheren, metadata bewerken, scans, analyses en vernieuwingen van metadata starten
Page StreamingPagina voor pagina lezen, bijvoorbeeld in de webreader
File DownloadHet bestand van een boek downloaden
Kobo SyncEen Kobo-e-reader synchroniseren, samen met File Download
KOReader SyncDe leesvoortgang met KOReader synchroniseren

Een gebruiker verwijderen wist al zijn leesvoortgang, zonder weg terug: een kopie van /config die u vlak daarvoor maakt, houdt u de regie.

Een wachtwoord opnieuw instellen via de opdrachtregel

De documentatie voegt de opdracht toe aan compose.yaml, onder de dienst komga; Komga voert de wijziging door en start daarna zoals gewoonlijk. Herstart de dienst, verwijder daarna de regel en herstart hem nog een keer:

compose.yaml, onder de dienst komga
    command: --newpassword=YourNewPassword --reset=admin@example.org
Terminal
docker compose up -d

De opdracht --list-users, op dezelfde manier gebruikt, toont de lijst van accounts in de logboeken.

Configuratie: variabelen of application.yml

Komga heeft voor elke instelling een standaardwaarde: de configuratie verandert alleen zijn gedrag. Ze gebeurt met omgevingsvariabelen, de eenvoudigste route met Docker Compose, of met een bestand application.yml dat u aanmaakt in de map /config, waar de Docker-image het laadt. Om van de naam van een eigenschap de naam van een variabele te maken, vervangt u punten door underscores, verwijdert u de streepjes en zet u alles in hoofdletters.

VariabeleEigenschapStandaardWat ze doet
SERVER_PORTserver.port25600De poort van de API en de webinterface
SERVER_SERVLET_CONTEXTPATHserver.servlet.context-path/De basis-URL, om Komga vanuit een submap te serveren
SPRING_SESSION_TIMEOUTspring.session.timeout7 dagenHoe lang een inactieve sessie duurt, bijvoorbeeld 14d of 24h
KOMGA_CORS_ALLOWEDORIGINSkomga.cors.allowed-originsGeenDe oorsprongen die voor CORS zijn toegestaan
LOGGING_LEVEL_ORG_GOTSON_KOMGAlogging.level.org.gotson.komgaNiet ingesteldDEBUG voor gedetailleerde logboeken

De poort en de basis-URL kunnen ook onder “Server Settings” worden ingesteld, en die instelling gaat dan voor op de configuratie. Voor het Java-geheugen voegt u de variabele JAVA_TOOL_OPTIONS toe aan de sectie environment. Het voorbeeld van de documentatie stelt een maximum van 4 GB in:

compose.yaml, in environment
      - JAVA_TOOL_OPTIONS=-Xmx4g

Het voorbeeldbestand application.yml van de documentatie begint met het pad van de database. Houd het met Docker op /config/database.sqlite, de standaardwaarde: op elke andere plek zou de database binnen de container worden aangemaakt en verloren gaan als die opnieuw wordt gemaakt. Neem uit het voorbeeld alleen de regels over die u nodig hebt.

HTTPS en de reverse proxy

De documentatie raadt aan een reverse proxy voor Komga te plaatsen die een geldig certificaat verkrijgt, en stelt Caddy voor, dat zelf zijn Let's Encrypt-certificaten aanmaakt. De proxy moet drie headers zetten, zodat Komga het openbare adres en het protocol van elk verzoek kent:

Met Caddy

Op een subdomein, zonder basis-URL in Komga, zet Caddy deze headers zelf:

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

In een submap stelt u eerst de basis-URL van Komga in op /komga, onder “Server Settings” of met SERVER_SERVLET_CONTEXTPATH, en daarna:

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

Met Nginx

Het Nginx-voorbeeld van de documentatie stuurt ook WebSocket-verbindingen door. Voeg dit blok map toe aan de sectie http van /etc/nginx/nginx.conf:

nginx.conf, in http
map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

Dit siteblok gebruikt de instellingen uit het voorbeeld van de documentatie, op poort 80 zodat Certbot HTTPS kan instellen. De regel X-Forwarded-Host is toegevoegd, omdat de lijst met headers van de documentatie erom vraagt:

Nginx-blok
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

Het volledige voorbeeld van de documentatie toont de eindversie: poort 80 omgeleid naar HTTPS, en het blok op 443 met de paden van zijn certificaat.

Bibliotheken, scans en imports

Een bibliotheek is een groep boeken onder een hoofdmap. Komga maakt een serie aan voor elke submap, op elke diepte, en een boek voor elk bestand, geplaatst in de serie van zijn bovenliggende map. De metadata van EPUB-bestanden en van de ComicInfo.xml-bestanden in archieven gaan voor op de namen van mappen en bestanden.

  1. Zet uw bestanden op de server, in één submap van ~/komga/data per bibliotheek, via SFTP of met rsync.
  2. Klik in de interface op + naast “Libraries”.
  3. Geef de bibliotheek een naam, kies haar hoofdmap met “Browse”, bijvoorbeeld /data/manga, en klik daarna op “Add”.
Terminal, op uw computer
rsync -av manga/ user@komga.example.com:komga/data/manga/

De prullenbak

Een boek waarvan het bestand verdwijnt, gaat naar de prullenbak, gemarkeerd als “Unavailable”, in plaats van te worden verwijderd: de metadata, de leesvoortgang en de lijsten komen terug als het bestand op zijn plek weer verschijnt. U kunt uw bestanden dus hernoemen en verplaatsen zonder iets te verliezen. De prullenbak wordt met de hand geleegd, of na elke scan als u die optie inschakelt, die de items dan meteen verwijdert.

Boeken importeren

Het scherm “Import”, “Books” plaatst in uw series boeken die in een andere map van de server staan, bijvoorbeeld /data/import. Voor elk bestand kiest u de doelserie, het nummer en de naam; bij een nummer dat al in gebruik is, wordt voorgesteld het bestaande boek te vervangen, met beide naast elkaar getoond. Komga verplaatst de bestanden, of maakt harde links wanneer het bestandssysteem dat toelaat, en kopieert ze anders.

Wie de hoofdmap van een bibliotheek wijzigt naar een pad dat los staat van het oude, wist haar series, boeken en leesvoortgang. De FAQ beschrijft hoe u haar verplaatst: bestandshashes aan, automatisch legen van de prullenbak uit, en daarna een scan vóór de verplaatsing.

Overal lezen: OPDS, Kobo en KOReader

De webreader opent in de browser, op het adres van de server. Voor een app of een e-reader biedt Komga drie toegangen, die allemaal via HTTPS moeten worden geserveerd.

OPDS

Komga werkt met elke OPDS-app, versie 1 of 2. Geef de app een van deze adressen, en daarna het e-mailadres en het wachtwoord van uw Komga-account:

OPDS-adressen
https://komga.example.com/opds/v2/catalog
https://komga.example.com/opds/v1.2/catalog

De catalogus in versie 1.2 voegt zoeken op serie toe, via OpenSearch, en pagina voor pagina lezen zonder te downloaden, via de extensie OPDS PSE. De documentatie houdt een lijst bij van geteste apps, op Android, iOS en elders, met wat elk ervan ondersteunt.

Kobo Sync

Uw Kobo-e-reader synchroniseert met Komga in plaats van met de officiële Kobo-servers. De EPUB-boeken uit alle bibliotheken komen binnen met hun metadata en omslag, tijdens het verzenden omgezet naar KEPUB door Kepubify, dat in de Docker-image zit. De leesvoortgang wordt in beide richtingen gesynchroniseerd.

  1. Geef het account de rollen Kobo Sync en File Download.
  2. Genereer een API-sleutel op uw accountpagina, “Account Settings”, en noteer hem: hij wordt maar één keer getoond. Gebruik één sleutel per e-reader.
  3. Sluit de Kobo aan op uw computer en open het bestand .kobo/Kobo/Kobo eReader.conf, met verborgen bestanden zichtbaar.
  4. Vervang in de groep [OneStoreServices] de regel api_endpoint door het adres van uw server, gevolgd door uw sleutel.
Kobo eReader.conf
api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY

KOReader Sync

KOReader leest Komga via OPDS, en synchroniseert zijn leesvoortgang via de synchronisatieserver van Komga:

  1. Geef het account de rol KOReader Sync, en schakel in de opties van de bibliotheek bestandshashes voor KOReader in.
  2. Genereer een API-sleutel op uw accountpagina.
  3. Ga in KOReader, met een boek open, naar “Progress sync”, daarna “Custom sync server”, en voer https://komga.example.com/koreader in.
  4. Voer in “Register / Login” de API-sleutel in als gebruikersnaam, en een willekeurige waarde als wachtwoord, die Komga niet gebruikt.
  5. Kies onder “Document matching method” de optie “Binary”.

Back-ups

Alles wat Komga over uw boeken weet, staat in /config; uw boeken zelf blijven in /data. Dit bevat /config met de standaardconfiguratie:

OnderdeelWat het bevat
database.sqliteDe hoofddatabase: bibliotheken, series, boeken, metadata, gebruikers, leesvoortgang, collecties, leeslijsten en gegenereerde miniaturen
tasks.sqliteOpenstaande achtergrondtaken
sessions.sqliteDe inlogsessies, sinds versie 1.30.0 standaard in de database opgeslagen
lucene/De zoekindex
fonts/De lettertypen
logs/De logboeken, waaronder komga.log
application.ymlUw configuratie, als u er een hebt aangemaakt

De SQLite-databases worden gekopieerd terwijl Komga gestopt is, voor een consistente kopie. Vanuit de map van compose.yaml:

Terminal, in ~/komga
docker compose stop
tar -czf komga-config-$(date +%F).tar.gz config
docker compose start

Stuur dit archief buiten de server, zo vaak als u boeken toevoegt en leest. Bewaar ook een kopie van uw boeken, met de omslagen die u naast de bestanden bewaart: het is het zwaarste volume, maar het verandert weinig, en rsync stuurt alleen wat nieuw is. Bewaard op de schijf van de server maken deze archieven ook deel uit van zijn nachtelijke back-ups.

Om terug te zetten stopt u Komga, vervangt u de map config door die uit het archief, controleert u dat ze nog eigendom is van de gebruiker uit compose.yaml, en start u Komga weer.

Updates

Met Docker Compose geeft de documentatie deze opdrachten, vanuit de map van compose.yaml. De map /config, gekoppeld vanaf de server, bewaart uw instellingen:

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

Wie doet wat op een managed VPS

Self-hosting vraagt dat u naast de applicatie ook de server beheert. Op een managed VPS neemt ons team de server voor zijn rekening en houdt het uw instantie proactief in de gaten; Komga blijft uw software, met zijn instellingen en uw boeken.

OnderwerpOns teamU
De serverSysteem- en beveiligingsupdates, ingrepen op de server inbegrepenHet moment dat bij uw activiteit past
De monitoringServer 24 uur per dag en 7 dagen per week bewaakt, met ingrijpen zonder op uw oproep te wachtenHet lezen van de logboeken van uw instantie
KomgaProactief toezicht: fouten, vertragingen, geheugen en schijfruimte opgespoord, correctie aangeradenDe installatie, de updates en de instellingen, die u toepast, zelf of via uw AI-assistent
De bibliotheken en de lezersDe server die ze draagt, bewaakt en geback-uptDe bibliotheken, de accounts, de rollen en de API-sleutels
De back-upsElke nacht, versleuteld en buiten de machine bewaard; terugzetten inbegrepenDe eigen kopieën van Komga, en het verzoek om terug te zetten, wanneer u dat nodig hebt
De migratieUw huidige server gemigreerd, gratisHet moment van de overschakeling

Wilt u liever dat ons team in de applicatie zelf ingrijpt, dan wordt die dienstverlening per uur of tegen een vast bedrag gefactureerd, met een offerte voordat het werk begint.

Komga, op een server die voor u wordt beheerd

Met een Managed VPS van Simafri houdt ons team de server van uw Komga-instantie up-to-date, bewaakt hem dag en nacht en grijpt in zonder op uw oproep te wachten; het houdt ook uw instantie proactief in de gaten en raadt u de nuttige correcties aan, die u toepast, zelf of via uw AI-assistent. De back-ups worden elke nacht versleuteld en buiten de machine bewaard, het terugzetten is inbegrepen, en de migratie van uw huidige server is gratis.

Ontdek Managed VPS

Veelgestelde vragen

Is Komga gratis voor een bedrijf?

Ja. Komga valt onder de MIT-licentie: u mag het in een bedrijf gebruiken, wijzigen en verspreiden zonder een licentie te kopen, op voorwaarde dat u de copyrightvermelding behoudt. Wat overblijft, zijn de kosten van de server waarop het draait.

Hoeveel geheugen heeft Komga nodig?

De documentatie legt geen minimum vast. Standaard begrenst Java het geheugen van Komga, meestal rond 1 GB. Tonen de logboeken fouten OutOfMemoryException, verhoog dan de limiet met JAVA_TOOL_OPTIONS, bijvoorbeeld -Xmx4g voor 4 GB.

Hoe installeer ik Komga met Docker Compose?

Maak een compose.yaml met de image gotson/komga, poort 25600 gepubliceerd op 127.0.0.1, een map config gekoppeld op /config, een map data gekoppeld op /data, en een gebruiker die eigenaar is van beide, en voer docker compose up -d uit. Zet daarna een reverse proxy met HTTPS voor poort 25600.

Hoe maak ik het beheerdersaccount van Komga aan?

Bij het eerste bezoek vraagt Komga een e-mailadres en een wachtwoord: dat eerste account krijgt alle rollen. Maak het aan via een SSH-tunnel voordat u de server openstelt voor het publiek, en maak daarna de andere accounts aan in Server Settings, Users.

Welk OPDS-adres geef ik mijn leesapp?

Het adres van uw server gevolgd door /opds/v2/catalog voor OPDS 2, of door /opds/v1.2/catalog voor OPDS 1.2, met het e-mailadres en het wachtwoord van uw Komga-account.

Hoe synchroniseer ik een Kobo-e-reader met Komga?

Geef het account de rollen Kobo Sync en File Download, genereer een API-sleutel in Account Settings, en vervang daarna de regel api_endpoint van het bestand Kobo eReader.conf door https://uw-server/kobo/uw-sleutel. Alleen EPUB-boeken worden gesynchroniseerd.

Hoe maak ik een back-up van Komga?

Stop Komga, archiveer de map config, start Komga weer, en stuur het archief buiten de server. Bewaar ook een kopie van uw boeken. Maak vlak voor elke update een kopie.

Dekt een managed VPS ook Komga?

Een managed VPS dekt de server: systeem, beveiliging, monitoring en back-ups. Ons team houdt ook uw instantie proactief in de gaten en raadt u de nuttige correcties aan, die u toepast. Een ingreep in de applicatie wordt per uur of tegen een vast bedrag gefactureerd.

Neem contact op