Hoste Komga på en Managed VPS: dine tegneserier og manga på din egen server

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.

Simon Vasconcelos Lee Af Udgivet den 22. november 2026Læsetid: 14 minutter

Alle guider

Det vigtigste

  1. MIT-licensen tillader at bruge, ændre og videredistribuere Komga frit, både i virksomheder og andre steder, så længe du beholder dens copyrightmeddelelse.
  2. Lagerpladsen dimensioneres efter din samling, som ligger i /data; databasen, indekset og logfilerne ligger i /config, på en lokal disk.
  3. Installér med Docker Compose: imaget gotson/komga, port 25600 publiceret lokalt bag en reverse proxy med HTTPS, og en bruger, der ejer begge mapper.
  4. Den første konto, der oprettes, bliver administrator: opret den gennem en SSH-tunnel, før du åbner serveren for offentligheden.
  5. Stop Komga, kopiér mappen /config væk fra serveren, behold en kopi af dine bøger, og opdatér med docker compose pull.

Hvad Komga gør

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.

Hvad MIT-licensen tillader

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.

Hukommelse, CPU og lagerplads: dimensionering af serveren

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.

Java-hukommelsen

CPU'en

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

Lagerplads til dine bøger

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:

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.

Installation med Docker Compose

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:

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

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

Uden Docker: jar-filen

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:

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

Den første konto og brugerne

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.

Terminal, på din computer
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:

RolleHvad den tillader
AdministratorAdministrere biblioteker, brugere og samlinger, redigere metadata, starte scanninger, analyser og opdateringer af metadata
Page StreamingLæse side for side, for eksempel i webreaderen
File DownloadDownloade filen til en bog
Kobo SyncSynkronisere en Kobo-læser, sammen med File Download
KOReader SyncSynkronisere 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.

Nulstil en adgangskode fra kommandolinjen

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:

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

Kommandoen --list-users, brugt på samme måde, skriver listen over konti i logfilerne.

Konfiguration: variabler eller application.yml

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.

VariabelEgenskabStandardHvad den gør
SERVER_PORTserver.port25600Porten til API'et og webgrænsefladen
SERVER_SERVLET_CONTEXTPATHserver.servlet.context-path/Basis-URL'en, for at servere Komga fra en undermappe
SPRING_SESSION_TIMEOUTspring.session.timeout7 dageHvor længe en inaktiv session varer, for eksempel 14d eller 24h
KOMGA_CORS_ALLOWEDORIGINSkomga.cors.allowed-originsIngenDe oprindelser, der er tilladt for CORS
LOGGING_LEVEL_ORG_GOTSON_KOMGAlogging.level.org.gotson.komgaIkke angivetDEBUG 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:

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

HTTPS og reverse proxy

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:

Med Caddy

På et underdomæne, uden basis-URL i Komga, sætter Caddy selv disse headere:

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

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

Med Nginx

Dokumentationens Nginx-eksempel videresender også WebSocket-forbindelser. Tilføj denne blok map i sektionen http i /etc/nginx/nginx.conf:

nginx.conf, i http
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:

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

Dokumentationens fulde eksempel viser den endelige version: port 80 omdirigeret til HTTPS og blokken på 443 med stierne til certifikatet.

Biblioteker, scanninger og importer

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.

  1. Læg dine filer på serveren, i én undermappe af ~/komga/data pr. bibliotek, via SFTP eller med rsync.
  2. Klik i grænsefladen på + ud for «Libraries».
  3. Giv biblioteket et navn, vælg dets rodmappe med «Browse», for eksempel /data/manga, og klik derefter på «Add».
Terminal, på din computer
rsync -av manga/ user@komga.example.com:komga/data/manga/

Papirkurven

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.

Import af bøger

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.

Læs overalt: OPDS, Kobo og KOReader

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.

OPDS

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:

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

Kobo Sync

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.

  1. Giv kontoen rollerne Kobo Sync og File Download.
  2. Generér en API-nøgle på din kontoside, «Account Settings», og skriv den ned: den vises kun én gang. Brug én nøgle pr. læser.
  3. Slut Kobo'en til din computer, og åbn filen .kobo/Kobo/Kobo eReader.conf, med skjulte filer vist.
  4. I gruppen [OneStoreServices] erstatter du linjen api_endpoint med din servers adresse efterfulgt af din nøgle.
Kobo eReader.conf
api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY

KOReader Sync

KOReader læser Komga via OPDS og synkroniserer sine læsefremskridt gennem Komgas synkroniseringsserver:

  1. Giv kontoen rollen KOReader Sync, og slå filhashes til KOReader til i bibliotekets indstillinger.
  2. Generér en API-nøgle på din kontoside.
  3. I KOReader, med en bog åben, går du til «Progress sync», derefter «Custom sync server», og indtaster https://komga.example.com/koreader.
  4. Under «Register / Login» indtaster du API-nøglen som brugernavn og en vilkårlig værdi som adgangskode, som Komga ikke bruger.
  5. Under «Document matching method» vælger du «Binary».

Backup

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:

ElementHvad det rummer
database.sqliteHoveddatabasen: biblioteker, serier, bøger, metadata, brugere, læsefremskridt, samlinger, læselister og genererede miniaturer
tasks.sqliteVentende baggrundsopgaver
sessions.sqliteLogin-sessionerne, som standard gemt i databasen siden version 1.30.0
lucene/Søgeindekset
fonts/Skrifttyperne
logs/Logfilerne, herunder komga.log
application.ymlDin konfiguration, hvis du har oprettet en

SQLite-databaserne kopieres, mens Komga er stoppet, for at få en konsistent kopi. Fra mappen med compose.yaml:

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

Opdateringer

Med Docker Compose giver dokumentationen disse kommandoer, fra mappen med compose.yaml. Mappen /config, monteret fra serveren, bevarer dine indstillinger:

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

Hvem gør hvad på en Managed VPS

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.

EmneVores teamsDig
ServerenOpdateringer af system og sikkerhed, indgreb på serveren inkluderetDet tidspunkt, der passer til din drift
OvervågningenServeren følges døgnet rundt, alle ugens dage, med indgreb uden at vente på dit opkaldGennemlæsning af din instans' logfiler
KomgaProaktiv opfølgning: fejl, langsomme svartider, hukommelse og diskplads opdages, og en rettelse anbefalesInstallation, opdateringer og indstillinger, som du gennemfører, selv eller med din AI-assistent
Biblioteker og læsereDen server, der bærer dem, overvåget og sikkerhedskopieretBibliotekerne, kontiene, rollerne og API-nøglerne
BackupHver nat, krypteret og opbevaret uden for maskinen; gendannelse inkluderetDe kopier, der er specifikke for Komga, og anmodningen om gendannelse, når du får brug for den
MigreringenDin nuværende server flyttes, uden beregningTidspunktet 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.

Komga på en server, der passes for dig

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.

Opdag Managed VPS

Ofte stillede spørgsmål

Er Komga gratis for en virksomhed?

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.

Hvor meget hukommelse har Komga brug for?

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.

Hvordan installerer man Komga med Docker Compose?

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.

Hvordan opretter man administratorkontoen i Komga?

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.

Hvilken OPDS-adresse giver jeg min læseapp?

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.

Hvordan synkroniserer man en Kobo-læser med Komga?

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.

Hvordan tager man backup af Komga?

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.

Dækker en Managed VPS Komga?

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.

Kontakt os