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.
Door Simon Vasconcelos Lee
Gepubliceerd op 22 november 2026Leestijd: 14 minuten
/data staat; de database, de index en de logboeken staan in /config, op een lokale schijf.gotson/komga, poort 25600 lokaal gepubliceerd achter een reverse proxy met HTTPS, en een gebruiker die eigenaar is van beide mappen./config buiten de server, bewaar een kopie van uw boeken, en werk bij met docker compose pull.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.
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.
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.
OutOfMemoryException in de logboeken. De limiet wordt dan verhoogd met de variabele JAVA_TOOL_OPTIONS, verderop getoond.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”.
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:
/data voor boeken en imports: de documentatie vraagt u daar uw bibliotheken en uw importmap te plaatsen, zodat imports harde links maken in plaats van kopieën. Buiten hetzelfde bestandssysteem neemt elke import de ruimte van een kopie in./config bevat de hoofddatabase, met de miniaturen die voor elk boek worden gegenereerd, de database van de taken, de database van de sessies, de zoekindex en de logboeken, die de standaardconfiguratie 7 dagen bewaart en tot 1 GB beperkt. Ze groeit mee met de omvang van uw bibliotheken./config: de SQLite-databases mogen nooit op een netwerkshare zoals CIFS of NFS staan. Komga controleert dat bij het opstarten en stopt als dat niet zo is.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.
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:
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:
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: dit is de belangrijkste afwijking van het voorbeeld van de documentatie, dat hem op alle adressen publiceert. De documentatie raadt HTTPS met klem aan zodra Komga buiten uw lokale netwerk wordt opengesteld, omdat het HTTP-basisauthenticatie gebruikt. De interface is dan alleen via de reverse proxy bereikbaar.user staat. De documentatie vraagt dat de gekoppelde mappen eigendom zijn van diezelfde gebruiker: zo verdwijnen problemen met rechten./config bevat de database en de configuratie van Komga, op een lokale schijf./data bevat uw boeken en uw importmap. Elke bibliotheek krijgt daar haar eigen submap.1.x volgt de laatst gepubliceerde versie 1; 1.30.1 zet een versie vast. De documentatie beschrijft latest als de laatste commit.version uit het voorbeeld van de documentatie is weggelaten: Docker Compose beschouwt hem nu als verouderd en negeert hem.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:
java -version
java -jar komga-1.30.1.jar
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.
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:
| Rol | Wat hij toestaat |
|---|---|
| Administrator | Bibliotheken, gebruikers en collecties beheren, metadata bewerken, scans, analyses en vernieuwingen van metadata starten |
| Page Streaming | Pagina voor pagina lezen, bijvoorbeeld in de webreader |
| File Download | Het bestand van een boek downloaden |
| Kobo Sync | Een Kobo-e-reader synchroniseren, samen met File Download |
| KOReader Sync | De 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.
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:
command: --newpassword=YourNewPassword --reset=admin@example.org
docker compose up -d
De opdracht --list-users, op dezelfde manier gebruikt, toont de lijst van accounts in de logboeken.
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.
| Variabele | Eigenschap | Standaard | Wat ze doet |
|---|---|---|---|
SERVER_PORT | server.port | 25600 | De poort van de API en de webinterface |
SERVER_SERVLET_CONTEXTPATH | server.servlet.context-path | / | De basis-URL, om Komga vanuit een submap te serveren |
SPRING_SESSION_TIMEOUT | spring.session.timeout | 7 dagen | Hoe lang een inactieve sessie duurt, bijvoorbeeld 14d of 24h |
KOMGA_CORS_ALLOWEDORIGINS | komga.cors.allowed-origins | Geen | De oorsprongen die voor CORS zijn toegestaan |
LOGGING_LEVEL_ORG_GOTSON_KOMGA | logging.level.org.gotson.komga | Niet ingesteld | DEBUG 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:
- 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.
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:
X-Forwarded-For, gezet of aangevuld;X-Forwarded-Proto;X-Forwarded-Host.Op een subdomein, zonder basis-URL in Komga, zet Caddy deze headers zelf:
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:
example.com {
reverse_proxy /komga/* 127.0.0.1:25600
}
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:
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:
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
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.
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.
~/komga/data per bibliotheek, via SFTP of met rsync./data/manga, en klik daarna op “Add”.rsync -av manga/ user@komga.example.com:komga/data/manga/
/data/manga en /data/comics staan naast elkaar; /data en /data/manga kunnen niet samen.#recycle.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.
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.
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.
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:
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.
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.
.kobo/Kobo/Kobo eReader.conf, met verborgen bestanden zichtbaar.[OneStoreServices] de regel api_endpoint door het adres van uw server, gevolgd door uw sleutel.api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY
api_endpoint, 443 voor een HTTPS-adres.KOReader leest Komga via OPDS, en synchroniseert zijn leesvoortgang via de synchronisatieserver van Komga:
https://komga.example.com/koreader in.Alles wat Komga over uw boeken weet, staat in /config; uw boeken zelf blijven in /data. Dit bevat /config met de standaardconfiguratie:
| Onderdeel | Wat het bevat |
|---|---|
database.sqlite | De hoofddatabase: bibliotheken, series, boeken, metadata, gebruikers, leesvoortgang, collecties, leeslijsten en gegenereerde miniaturen |
tasks.sqlite | Openstaande achtergrondtaken |
sessions.sqlite | De inlogsessies, sinds versie 1.30.0 standaard in de database opgeslagen |
lucene/ | De zoekindex |
fonts/ | De lettertypen |
logs/ | De logboeken, waaronder komga.log |
application.yml | Uw 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:
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.
Met Docker Compose geeft de documentatie deze opdrachten, vanuit de map van compose.yaml. De map /config, gekoppeld vanaf de server, bewaart uw instellingen:
docker compose pull
docker compose up -d
docker image prune
/config.jar-bestand stopt u Komga en start u het daarna met de jar van de nieuwe versie.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.
| Onderwerp | Ons team | U |
|---|---|---|
| De server | Systeem- en beveiligingsupdates, ingrepen op de server inbegrepen | Het moment dat bij uw activiteit past |
| De monitoring | Server 24 uur per dag en 7 dagen per week bewaakt, met ingrijpen zonder op uw oproep te wachten | Het lezen van de logboeken van uw instantie |
| Komga | Proactief toezicht: fouten, vertragingen, geheugen en schijfruimte opgespoord, correctie aangeraden | De installatie, de updates en de instellingen, die u toepast, zelf of via uw AI-assistent |
| De bibliotheken en de lezers | De server die ze draagt, bewaakt en geback-upt | De bibliotheken, de accounts, de rollen en de API-sleutels |
| De back-ups | Elke nacht, versleuteld en buiten de machine bewaard; terugzetten inbegrepen | De eigen kopieën van Komga, en het verzoek om terug te zetten, wanneer u dat nodig hebt |
| De migratie | Uw huidige server gemigreerd, gratis | Het 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Simafri
Laten we het over uw website hebben
Vertel ons in een paar woorden over uw project: wij nemen snel contact met u op.
Bedankt! Uw aanvraag is verzonden. We nemen spoedig contact met u op.
Liever per e-mail? Schrijf ons op support@simafri.com.