At hoste Komga på en Managed VPS betyder, at du læser dine tegneserier, manga og e-bøger fra en maskine, der er din egen, og som vores teams holder opdateret og overvåger dag og nat. Komga er en medieserver og fri software under MIT-licensen. Denne guide følger den officielle dokumentation: den hukommelse og lagerplads, du skal regne med, installation med Docker Compose, den første konto, konfigurationen, HTTPS, bibliotekerne, læsning via OPDS, Kobo og KOReader, backup og opdateringer.
Af Simon Vasconcelos Lee
Udgivet den 22. november 2026Læsetid: 14 minutter
/data; databasen, indekset og logfilerne ligger i /config, på en lokal disk.gotson/komga, port 25600 publiceret lokalt bag en reverse proxy med HTTPS, og en bruger, der ejer begge mapper./config væk fra serveren, behold en kopi af dine bøger, og opdatér med docker compose pull.Komga er en medieserver til dine tegneserier, manga, fransk-belgiske album, blade og e-bøger. Du peger den på de mapper, der rummer dine filer, den ordner dem i biblioteker, serier og bøger og serverer dem derefter til en browser eller en læseapp. Den kører alle steder, hvor Java eller Docker kører.
Komga udgives under MIT-licensen, i Gauthier Roebroecks navn. Den giver gratis ret til at bruge, kopiere, ændre, sammenflette, udgive, distribuere, give underlicens til og sælge kopier af softwaren. Du kan altså køre den for dig selv, din familie, din forening eller din virksomhed uden at skulle købe en licens.
Den eneste betingelse er at beholde copyrightmeddelelsen og licensteksten i alle kopier eller væsentlige dele af softwaren. Teksten leverer softwaren «som den er», uden garanti.
Dokumentationen fastsætter ingen minimumskonfiguration. Til gengæld oplyser den det, der betyder noget for dimensioneringen af serveren: hukommelsen i den virtuelle Java-maskine, de opgaver, der bruger CPU'en, og frem for alt den plads, dine filer fylder.
OutOfMemoryException i logfilerne. Grænsen hæves så med variablen JAVA_TOOL_OPTIONS, som vises længere nede.CPU'en arbejder mest under scanning og analyse af bibliotekerne. For hvert bibliotek advarer dokumentationen om, at beregning af filhashes, sidehashes og KOReader-hashes, ligesom analyse af sidernes dimensioner, kan bruge mange ressourcer på et stort bibliotek. Antallet af tråde til baggrundsopgaver indstilles under «Server Settings».
Det er den største post, og du måler den selv: størrelsen på din samling plus plads til de bøger, du regner med at tilføje. Komga læser dine filer, hvor de ligger, og kopierer dem ikke. Nogle få punkter i dokumentationen ændrer regnestykket:
/data til bøger og importer: dokumentationen beder dig lægge dine biblioteker og din importmappe der, så importer laver hårde links i stedet for kopier. Uden for det samme filsystem fylder hver import det samme som en kopi./config rummer hoveddatabasen med de miniaturer, der genereres for hver bog, opgavedatabasen, sessionsdatabasen, søgeindekset og logfilerne, som standardkonfigurationen gemmer i 7 dage og begrænser til 1 GB. Den vokser med størrelsen på dine biblioteker./config: SQLite-databaserne må aldrig ligge på et netværksdrev som CIFS eller NFS. Komga kontrollerer det ved opstart og stopper, hvis det ikke er tilfældet.På en Managed VPS fortæller du os om din samling, dens størrelse, hvor hurtigt den vokser, og hvor mange læsere du har, og vi anbefaler den rette størrelse.
Dokumentationen udgiver imaget gotson/komga på Docker Hub og på ghcr.io, til amd64-, arm64- og arm-processorer. På en server med Docker opretter du en mappe til Komga med dens to undermapper og noterer dit bruger-id:
mkdir -p ~/komga/config ~/komga/data/import
cd ~/komga
id
Læg denne compose.yaml i den, hentet fra dokumentationens eksempel. Erstat 1000:1000 med de værdier for uid og gid, som id viser, og TZ med din tidszone:
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: det er den vigtigste afvigelse fra dokumentationens eksempel, som publicerer den på alle adresser. Dokumentationen anbefaler kraftigt HTTPS, så snart Komga åbnes uden for dit lokale netværk, fordi den bruger HTTP basic-godkendelse. Grænsefladen nås så kun gennem din reverse proxy.user. Dokumentationen beder om, at de monterede mapper ejes af den samme bruger: så forsvinder problemerne med rettigheder./config rummer Komgas database og konfiguration, på en lokal disk./data rummer dine bøger og din importmappe. Hvert bibliotek får sin egen undermappe der.1.x følger den seneste udgivne version 1; 1.30.1 låser en version fast. Dokumentationen beskriver latest som det seneste commit.version fra dokumentationens eksempel er udeladt: Docker Compose betragter den nu som forældet og ignorerer den.Dokumentationens anden vej til en Linux-server er jar-filen fra hver udgivelse, publiceret på GitHub. Den kræver Java 17 eller nyere og gemmer sin konfiguration i ~/.komga:
java -version
java -jar komga-1.30.1.jar
Ved første besøg beder Komga dig oprette en konto: en e-mailadresse og en adgangskode. Den første konto får alle roller, administration inkluderet, og «gør krav på» serveren. Så længe den ikke findes, svarer formularen alle, der når siden: opret den, før du åbner serveren for offentligheden, gennem en SSH-tunnel. Serverens port 25600 dukker så op på din computer, på http://localhost:25600. Tilføj -p og den SSH-port, der vises i dit kundeområde.
ssh -L 25600:127.0.0.1:25600 user@komga.example.com
Yderligere konti oprettes af administratoren under «Server Settings», «Users», med knappen +. Hver konto får de roller, den har brug for:
| Rolle | Hvad den tillader |
|---|---|
| Administrator | Administrere biblioteker, brugere og samlinger, redigere metadata, starte scanninger, analyser og opdateringer af metadata |
| Page Streaming | Læse side for side, for eksempel i webreaderen |
| File Download | Downloade filen til en bog |
| Kobo Sync | Synkronisere en Kobo-læser, sammen med File Download |
| KOReader Sync | Synkronisere læsefremskridt med KOReader |
Når en bruger slettes, forsvinder alle dennes læsefremskridt, uden mulighed for at fortryde: en kopi af /config taget lige før giver dig fuld kontrol.
Dokumentationen tilføjer kommandoen i compose.yaml, under tjenesten komga; Komga gennemfører ændringen og starter derefter som normalt. Genstart tjenesten, fjern derefter linjen og genstart den en gang til:
command: --newpassword=YourNewPassword --reset=admin@example.org
docker compose up -d
Kommandoen --list-users, brugt på samme måde, skriver listen over konti i logfilerne.
Komga har standardværdier for alle indstillinger: konfigurationen ændrer kun dens opførsel. Den sker med miljøvariabler, den nemmeste vej med Docker Compose, eller med en fil application.yml, som du opretter i mappen /config, hvor Docker-imaget indlæser den. For at gøre navnet på en egenskab til navnet på en variabel erstatter du punktummer med understregninger, fjerner bindestreger og skriver med store bogstaver.
| Variabel | Egenskab | Standard | Hvad den gør |
|---|---|---|---|
SERVER_PORT | server.port | 25600 | Porten til API'et og webgrænsefladen |
SERVER_SERVLET_CONTEXTPATH | server.servlet.context-path | / | Basis-URL'en, for at servere Komga fra en undermappe |
SPRING_SESSION_TIMEOUT | spring.session.timeout | 7 dage | Hvor længe en inaktiv session varer, for eksempel 14d eller 24h |
KOMGA_CORS_ALLOWEDORIGINS | komga.cors.allowed-origins | Ingen | De oprindelser, der er tilladt for CORS |
LOGGING_LEVEL_ORG_GOTSON_KOMGA | logging.level.org.gotson.komga | Ikke angivet | DEBUG for detaljerede logfiler |
Porten og basis-URL'en kan også angives under «Server Settings», og den indstilling går så forud for konfigurationen. Til Java-hukommelsen tilføjer du variablen JAVA_TOOL_OPTIONS i sektionen environment. Dokumentationens eksempel sætter et maksimum på 4 GB:
- JAVA_TOOL_OPTIONS=-Xmx4g
Dokumentationens eksempelfil application.yml begynder med stien til databasen. Med Docker skal den blive på /config/database.sqlite, dens standardværdi: alle andre steder ville databasen blive oprettet inde i containeren og gå tabt, når den genskabes. Behold kun de linjer fra eksemplet, du har brug for.
Dokumentationen anbefaler at sætte en reverse proxy foran Komga, der henter et gyldigt certifikat, og foreslår Caddy, som selv genererer sine Let's Encrypt-certifikater. Proxyen skal sætte tre headere, så Komga kender den offentlige adresse og protokollen for hver forespørgsel:
X-Forwarded-For, sat eller udvidet;X-Forwarded-Proto;X-Forwarded-Host.På et underdomæne, uden basis-URL i Komga, sætter Caddy selv disse headere:
komga.example.com {
reverse_proxy 127.0.0.1:25600
}
I en undermappe sætter du først Komgas basis-URL til /komga, under «Server Settings» eller med SERVER_SERVLET_CONTEXTPATH, og derefter:
example.com {
reverse_proxy /komga/* 127.0.0.1:25600
}
Dokumentationens Nginx-eksempel videresender også WebSocket-forbindelser. Tilføj denne blok map i sektionen http i /etc/nginx/nginx.conf:
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
Denne site-blok bruger indstillingerne fra dokumentationens eksempel, på port 80, så Certbot kan sætte HTTPS op. Linjen X-Forwarded-Host er tilføjet, da dokumentationens liste over headere beder om den:
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
Dokumentationens fulde eksempel viser den endelige version: port 80 omdirigeret til HTTPS og blokken på 443 med stierne til certifikatet.
Et bibliotek er en gruppe bøger under en rodmappe. Komga opretter en serie for hver undermappe, i en hvilken som helst dybde, og en bog for hver fil, placeret i serien for dens overordnede mappe. Metadata fra EPUB-filer og fra ComicInfo.xml-filerne i arkiverne går forud for navnene på mapper og filer.
~/komga/data pr. bibliotek, via SFTP eller med rsync./data/manga, og klik derefter på «Add».rsync -av manga/ user@komga.example.com:komga/data/manga/
/data/manga og /data/comics ligger side om side; /data og /data/manga kan ikke.#recycle, uden for scanningen.En bog, hvis fil forsvinder, flyttes til papirkurven, markeret «Unavailable», i stedet for at blive slettet: dens metadata, læsefremskridt og lister kommer tilbage, hvis filen dukker op igen på sin plads. Du kan altså omdøbe og flytte dine filer uden at miste noget. Papirkurven tømmes manuelt, eller efter hver scanning, hvis du slår den indstilling til, som så fjerner elementerne med det samme.
Skærmen «Import», «Books» placerer bøger, der ligger i en anden mappe på serveren, for eksempel /data/import, i dine serier. For hver fil vælger du målserien, nummeret og navnet; et nummer, der allerede er i brug, giver mulighed for at opgradere den eksisterende bog, med begge vist side om side. Komga flytter filerne eller laver hårde links, når filsystemet tillader det, og kopierer dem ellers.
Hvis et biblioteks rodmappe ændres til en sti uden forbindelse til den gamle, slettes dets serier, bøger og læsefremskridt. FAQ'en beskriver, hvordan det flyttes: filhashes slået til, automatisk tømning af papirkurven slået fra, og derefter en scanning før flytningen.
Webreaderen åbner i browseren, på serverens adresse. Til en app eller en e-bogslæser tilbyder Komga tre indgange, som alle skal serveres over HTTPS.
Komga fungerer med enhver OPDS-app, version 1 eller 2. Giv appen en af disse adresser og derefter e-mailadressen og adgangskoden til din Komga-konto:
https://komga.example.com/opds/v2/catalog
https://komga.example.com/opds/v1.2/catalog
Kataloget i version 1.2 tilføjer søgning efter serie via OpenSearch og læsning side for side uden download via udvidelsen OPDS PSE. Dokumentationen fører en liste over testede apps, på Android, iOS og andre steder, med det, hver enkelt understøtter.
Din Kobo-læser synkroniserer med Komga i stedet for Kobos officielle servere. EPUB-bøger fra alle biblioteker kommer frem med deres metadata og forside, konverteret til KEPUB i farten af Kepubify, som følger med i Docker-imaget. Læsefremskridt synkroniseres begge veje.
.kobo/Kobo/Kobo eReader.conf, med skjulte filer vist.[OneStoreServices] erstatter du linjen api_endpoint med din servers adresse efterfulgt af din nøgle.api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY
api_endpoint, 443 for en HTTPS-adresse.KOReader læser Komga via OPDS og synkroniserer sine læsefremskridt gennem Komgas synkroniseringsserver:
https://komga.example.com/koreader.Alt, hvad Komga ved om dine bøger, ligger i /config; selve dine bøger bliver i /data. Her er, hvad /config indeholder med standardkonfigurationen:
| Element | Hvad det rummer |
|---|---|
database.sqlite | Hoveddatabasen: biblioteker, serier, bøger, metadata, brugere, læsefremskridt, samlinger, læselister og genererede miniaturer |
tasks.sqlite | Ventende baggrundsopgaver |
sessions.sqlite | Login-sessionerne, som standard gemt i databasen siden version 1.30.0 |
lucene/ | Søgeindekset |
fonts/ | Skrifttyperne |
logs/ | Logfilerne, herunder komga.log |
application.yml | Din konfiguration, hvis du har oprettet en |
SQLite-databaserne kopieres, mens Komga er stoppet, for at få en konsistent kopi. Fra mappen med compose.yaml:
docker compose stop
tar -czf komga-config-$(date +%F).tar.gz config
docker compose start
Send arkivet væk fra serveren, lige så ofte som du tilføjer og læser bøger. Behold også en kopi af dine bøger, med de forsider, du gemmer ved siden af filerne: det er den største mængde, men den ændrer sig kun lidt, og rsync sender kun det nye. Gemt på serverens disk indgår disse arkiver også i dens natlige backup.
For at gendanne stopper du Komga, erstatter mappen config med den fra arkivet, kontrollerer, at den stadig ejes af brugeren i compose.yaml, og starter Komga igen.
Med Docker Compose giver dokumentationen disse kommandoer, fra mappen med compose.yaml. Mappen /config, monteret fra serveren, bevarer dine indstillinger:
docker compose pull
docker compose up -d
docker image prune
/config lige før hver opdatering.jar-filen stopper du Komga og starter den derefter med jar-filen fra den nye version.Selvhosting kræver, at du holder serveren ud over selve applikationen. På en Managed VPS tager vores teams sig af serveren og følger din instans proaktivt; Komga forbliver din software, med dens indstillinger og dine bøger.
| Emne | Vores teams | Dig |
|---|---|---|
| Serveren | Opdateringer af system og sikkerhed, indgreb på serveren inkluderet | Det tidspunkt, der passer til din drift |
| Overvågningen | Serveren følges døgnet rundt, alle ugens dage, med indgreb uden at vente på dit opkald | Gennemlæsning af din instans' logfiler |
| Komga | Proaktiv opfølgning: fejl, langsomme svartider, hukommelse og diskplads opdages, og en rettelse anbefales | Installation, opdateringer og indstillinger, som du gennemfører, selv eller med din AI-assistent |
| Biblioteker og læsere | Den server, der bærer dem, overvåget og sikkerhedskopieret | Bibliotekerne, kontiene, rollerne og API-nøglerne |
| Backup | Hver nat, krypteret og opbevaret uden for maskinen; gendannelse inkluderet | De kopier, der er specifikke for Komga, og anmodningen om gendannelse, når du får brug for den |
| Migreringen | Din nuværende server flyttes, uden beregning | Tidspunktet for omlægningen |
Hvis du foretrækker, at vores teams griber ind i selve applikationen, faktureres den ydelse pr. time eller som fast pris, med et overslag oplyst før indgrebet.
Med en Managed VPS fra Simafri holder vores teams serveren bag din Komga-instans opdateret, overvåger den dag og nat og griber ind uden at vente på dit opkald; de følger også din instans proaktivt og anbefaler dig de nyttige rettelser, som du gennemfører, selv eller med din AI-assistent. Backup krypteres hver nat og opbevares uden for maskinen, gendannelsen er inkluderet, og migreringen af din nuværende server sker uden beregning.
Ja. Komga er under MIT-licensen: du kan bruge, ændre og videredistribuere den i din virksomhed uden at skulle købe en licens, så længe du beholder dens copyrightmeddelelse. Tilbage er udgiften til den server, der kører den.
Dokumentationen fastsætter intet minimum. Som standard begrænser Java Komgas hukommelse, som regel til omkring 1 GB. Viser logfilerne fejl af typen OutOfMemoryException, hæver du grænsen med JAVA_TOOL_OPTIONS, for eksempel -Xmx4g for 4 GB.
Opret en compose.yaml med imaget gotson/komga, port 25600 publiceret på 127.0.0.1, en mappe config monteret på /config, en mappe data monteret på /data og en bruger, der ejer begge, og kør derefter docker compose up -d. Sæt så en reverse proxy med HTTPS foran port 25600.
Ved første besøg beder Komga om en e-mailadresse og en adgangskode: den første konto får alle roller. Opret den gennem en SSH-tunnel, før du åbner serveren for offentligheden, og opret derefter de andre konti under Server Settings, Users.
Din servers adresse efterfulgt af /opds/v2/catalog for OPDS 2 eller af /opds/v1.2/catalog for OPDS 1.2, med e-mailadressen og adgangskoden til din Komga-konto.
Giv kontoen rollerne Kobo Sync og File Download, generér en API-nøgle under Account Settings, og erstat derefter linjen api_endpoint i filen Kobo eReader.conf med https://your-server/kobo/your-key. Kun EPUB-bøger synkroniseres.
Stop Komga, arkivér mappen config, start Komga igen, og send arkivet væk fra serveren. Behold også en kopi af dine bøger. Tag en kopi lige før hver opdatering.
En Managed VPS dækker serveren: system, sikkerhed, overvågning og backup. Vores teams følger også din instans proaktivt og anbefaler dig de nyttige rettelser, som du gennemfører. Et indgreb i selve applikationen faktureres pr. time eller som fast pris.
Simafri
Lad os tale om din hjemmeside
Fortæl os om dit projekt med få ord: vi vender hurtigt tilbage til dig.
Tak! Din forespørgsel er sendt. Vi vender tilbage til dig hurtigst muligt.
Foretrækker du e-mail? Skriv til os på support@simafri.com.