Hosta Komga på en Managed VPS: dina serier och manga på din egen server

Att hosta Komga på en Managed VPS innebär att du läser dina serier, manga och e-böcker från en egen maskin, som våra team håller uppdaterad och bevakar dag och natt. Komga är en medieserver och fri programvara under MIT-licensen. Den här guiden följer den officiella dokumentationen: minnet och lagringen att planera för, installation med Docker Compose, det första kontot, konfigurationen, HTTPS, biblioteken, läsning via OPDS, Kobo och KOReader, säkerhetskopior och uppdateringar.

Simon Vasconcelos Lee Av Publicerad den 22 november 2026Lästid: 14 minuter

Alla guider

I korthet

  1. MIT-licensen tillåter fri användning, ändring och vidaredistribution av Komga, i företag som på andra håll, så länge du behåller dess upphovsrättsmeddelande.
  2. Lagringen dimensioneras efter din samling, som ligger i /data; databasen, indexet och loggarna ligger i /config, på en lokal disk.
  3. Installera med Docker Compose: avbilden gotson/komga, port 25600 publicerad lokalt bakom en omvänd proxy med HTTPS, och en användare som äger båda mapparna.
  4. Det första kontot som skapas blir administratör: skapa det genom en SSH-tunnel innan du öppnar servern för allmänheten.
  5. Stoppa Komga, kopiera mappen /config utanför servern, behåll en kopia av dina böcker och uppdatera med docker compose pull.

Det Komga gör

Komga är en medieserver för dina serietidningar, manga, fransk-belgiska seriealbum, tidskrifter och e-böcker. Du pekar ut mapparna som innehåller dina filer, och Komga ordnar dem i bibliotek, serier och böcker och serverar dem sedan till en webbläsare eller en läsapp. Det körs överallt där Java eller Docker körs.

Vad MIT-licensen tillåter

Komga ges ut under MIT-licensen, i Gauthier Roebroecks namn. Den ger kostnadsfritt rätten att använda, kopiera, ändra, slå samman, publicera, distribuera, underlicensiera och sälja kopior av programvaran. Du kan alltså köra det för dig själv, din familj, din förening eller ditt företag, utan att köpa någon licens.

Det enda villkoret är att behålla upphovsrättsmeddelandet och licenstexten i alla kopior eller väsentliga delar av programvaran. Texten tillhandahåller programvaran ”i befintligt skick”, utan garanti.

Minne, processor och lagring: dimensionera servern

Dokumentationen anger ingen minimikonfiguration. Däremot anger den det som spelar roll när servern dimensioneras: minnet i den virtuella Java-maskinen, uppgifterna som belastar processorn, och framför allt utrymmet som dina filer tar.

Java-minnet

Processorn

Processorn arbetar framför allt när biblioteken skannas och analyseras. För varje bibliotek varnar dokumentationen för att beräkning av filhashar, sidhashar och KOReader-hashar, liksom analys av sidornas mått, kan kräva mycket resurser i ett stort bibliotek. Antalet trådar för bakgrundsuppgifter ställs in under ”Server Settings”.

Lagring för dina böcker

Det här är den största posten, och du mäter den själv: storleken på din samling, plus plats för de böcker du tänker lägga till. Komga läser dina filer där de ligger och kopierar dem inte. Några punkter i dokumentationen ändrar kalkylen:

På en Managed VPS berättar du för oss om din samling, dess storlek, hur snabbt den växer och hur många läsare du har, så rekommenderar vi rätt storlek.

Installation med Docker Compose

Dokumentationen publicerar avbilden gotson/komga på Docker Hub och på ghcr.io, för processorerna amd64, arm64 och arm. På en server med Docker skapar du en mapp för Komga med dess två undermappar, och noterar ditt användar-id:

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

Lägg denna compose.yaml i den, hämtad från dokumentationens exempel. Ersätt 1000:1000 med värdena uid och gid som id visar, och TZ med din tidszon:

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

Utan Docker: jar-filen

Dokumentationens andra väg för en Linuxserver är jar-filen för varje version, publicerad på GitHub. Den kräver Java 17 eller senare och sparar sin konfiguration i ~/.komga:

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

Det första kontot och användarna

Vid första besöket ber Komga dig skapa ett konto: en e-postadress och ett lösenord. Det första kontot får alla roller, administration inräknad, och ”gör anspråk på” servern. Så länge det inte finns svarar formuläret alla som når sidan: skapa det innan du öppnar servern för allmänheten, genom en SSH-tunnel. Serverns port 25600 dyker då upp på din dator, på http://localhost:25600. Lägg till -p och SSH-porten som visas på din kundsida.

Terminal, på din dator
ssh -L 25600:127.0.0.1:25600 user@komga.example.com

Fler konton skapas av administratören, under ”Server Settings”, ”Users”, med knappen +. Varje konto får de roller det behöver:

RollVad den tillåter
AdministratorHantera bibliotek, användare och samlingar, redigera metadata, starta skanningar, analyser och uppdateringar av metadata
Page StreamingLäsa sida för sida, till exempel i läsaren på webben
File DownloadLadda ned filen för en bok
Kobo SyncSynkronisera en Kobo-läsplatta, tillsammans med File Download
KOReader SyncSynkronisera läsförloppet med KOReader

När en användare raderas försvinner hela dess läsförlopp, utan återvändo: en kopia av /config som tas strax innan ger dig full kontroll.

Återställa ett lösenord från kommandoraden

Dokumentationen lägger till kommandot i compose.yaml, under tjänsten komga; Komga genomför ändringen och startar sedan som vanligt. Starta om tjänsten, ta sedan bort raden och starta om den en gång till:

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

Kommandot --list-users, använt på samma sätt, skriver listan över konton i loggarna.

Konfiguration: variabler eller application.yml

Komga har standardvärden för alla inställningar: konfigurationen ändrar bara dess beteende. Den görs med miljövariabler, den enklaste vägen med Docker Compose, eller med en fil application.yml som du skapar i mappen /config, där Docker-avbilden läser in den. För att göra namnet på en egenskap till namnet på en variabel ersätter du punkter med understreck, tar bort bindestreck och skriver med versaler.

VariabelEgenskapStandardVad den gör
SERVER_PORTserver.port25600Porten för API:et och webbgränssnittet
SERVER_SERVLET_CONTEXTPATHserver.servlet.context-path/Bas-URL:en, för att servera Komga från en undermapp
SPRING_SESSION_TIMEOUTspring.session.timeout7 dagarHur länge en inaktiv session varar, till exempel 14d eller 24h
KOMGA_CORS_ALLOWEDORIGINSkomga.cors.allowed-originsIngaUrsprungen som tillåts för CORS
LOGGING_LEVEL_ORG_GOTSON_KOMGAlogging.level.org.gotson.komgaInte angivenDEBUG för detaljerade loggar

Porten och bas-URL:en kan också anges under ”Server Settings”, och den inställningen har då företräde framför konfigurationen. För Java-minnet lägger du till variabeln JAVA_TOOL_OPTIONS i avsnittet environment. Dokumentationens exempel sätter ett maximum på 4 GB:

compose.yaml, i environment
      - JAVA_TOOL_OPTIONS=-Xmx4g

Dokumentationens exempelfil application.yml börjar med sökvägen till databasen. Med Docker behåller du den på /config/database.sqlite, dess standardvärde: på alla andra platser skulle databasen skapas inne i containern och gå förlorad när den återskapas. Behåll bara de rader i exemplet som du behöver.

HTTPS och den omvända proxyn

Dokumentationen rekommenderar att du sätter en omvänd proxy framför Komga som skaffar ett giltigt certifikat, och föreslår Caddy, som själv genererar sina Let’s Encrypt-certifikat. Proxyn måste sätta tre huvuden, så att Komga känner till den publika adressen och protokollet för varje förfrågan:

Med Caddy

På en underdomän, utan bas-URL i Komga, sätter Caddy själv dessa huvuden:

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

I en undermapp sätter du först Komgas bas-URL till /komga, under ”Server Settings” eller med SERVER_SERVLET_CONTEXTPATH, och sedan:

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

Med Nginx

Dokumentationens Nginx-exempel vidarebefordrar också WebSocket-anslutningar. Lägg till detta block map i avsnittet http i /etc/nginx/nginx.conf:

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

Detta webbplatsblock använder inställningarna från dokumentationens exempel, på port 80 så att Certbot kan sätta upp HTTPS. Raden X-Forwarded-Host är tillagd, eftersom dokumentationens lista över huvuden kräver den:

Nginx-block
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 fullständiga exempel visar den slutliga versionen: port 80 omdirigerad till HTTPS, och blocket på 443 med sökvägarna till certifikatet.

Bibliotek, skanningar och importer

Ett bibliotek är en grupp böcker under en rotmapp. Komga skapar en serie för varje undermapp, på vilket djup som helst, och en bok för varje fil, placerad i serien för dess överordnade mapp. Metadata från EPUB-filer och från ComicInfo.xml-filerna i arkiven har företräde framför namnen på mappar och filer.

  1. Lägg dina filer på servern, i en undermapp till ~/komga/data per bibliotek, via SFTP eller med rsync.
  2. Klicka i gränssnittet på + bredvid ”Libraries”.
  3. Namnge biblioteket, välj dess rotmapp med ”Browse”, till exempel /data/manga, och klicka sedan på ”Add”.
Terminal, på din dator
rsync -av manga/ user@komga.example.com:komga/data/manga/

Papperskorgen

En bok vars fil försvinner flyttas till papperskorgen, markerad ”Unavailable”, i stället för att raderas: dess metadata, läsförlopp och listor kommer tillbaka om filen dyker upp igen på sin plats. Du kan alltså byta namn på och flytta dina filer utan att förlora något. Papperskorgen töms manuellt, eller efter varje skanning om du aktiverar det valet, som då tar bort objekten direkt.

Importera böcker

Skärmen ”Import”, ”Books” sorterar in böcker som ligger i en annan mapp på servern, till exempel /data/import, i dina serier. För varje fil väljer du målserien, numret och namnet; ett nummer som redan används ger möjlighet att uppgradera den befintliga boken, med båda visade sida vid sida. Komga flyttar filerna, eller skapar hårda länkar när filsystemet tillåter det, och kopierar dem annars.

Om ett biblioteks rotmapp ändras till en sökväg utan koppling till den gamla raderas dess serier, böcker och läsförlopp. Vanliga frågor beskriver hur det flyttas: filhashning aktiverad, automatisk tömning av papperskorgen avaktiverad, och sedan en skanning före flytten.

Läs var som helst: OPDS, Kobo och KOReader

Läsaren på webben öppnas i webbläsaren, på serverns adress. För en app eller en läsplatta erbjuder Komga tre ingångar, som alla ska serveras över HTTPS.

OPDS

Komga fungerar med alla OPDS-appar, version 1 eller 2. Ange en av dessa adresser i appen, och sedan e-postadressen och lösenordet för ditt Komga-konto:

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

Katalogen i version 1.2 lägger till sökning efter serie, via OpenSearch, och läsning sida för sida utan nedladdning, via tillägget OPDS PSE. Dokumentationen har en lista över testade appar, på Android, iOS och annat, med vad var och en stöder.

Kobo Sync

Din Kobo-läsplatta synkroniseras med Komga i stället för med Kobos officiella servrar. EPUB-böcker från alla bibliotek kommer fram med sina metadata och sitt omslag, konverterade till KEPUB i farten av Kepubify, som följer med i Docker-avbilden. Läsförloppet synkroniseras åt båda hållen.

  1. Ge kontot rollerna Kobo Sync och File Download.
  2. Generera en API-nyckel på din kontosida, ”Account Settings”, och skriv ned den: den visas bara en gång. Använd en nyckel per läsplatta.
  3. Anslut Kobo-plattan till din dator och öppna filen .kobo/Kobo/Kobo eReader.conf, med dolda filer visade.
  4. I gruppen [OneStoreServices] ersätter du raden api_endpoint med din servers adress följd av din nyckel.
Kobo eReader.conf
api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY

KOReader Sync

KOReader läser Komga via OPDS och synkroniserar sitt läsförlopp genom Komgas synkroniseringsserver:

  1. Ge kontot rollen KOReader Sync, och aktivera filhashning för KOReader i bibliotekets inställningar.
  2. Generera en API-nyckel på din kontosida.
  3. I KOReader, med en bok öppen, går du till ”Progress sync”, sedan ”Custom sync server”, och anger https://komga.example.com/koreader.
  4. Under ”Register / Login” anger du API-nyckeln som användarnamn, och valfritt värde som lösenord, som Komga inte använder.
  5. Under ”Document matching method” väljer du ”Binary”.

Säkerhetskopior

Allt som Komga vet om dina böcker ligger i /config; själva böckerna stannar i /data. Det här är vad /config innehåller med standardkonfigurationen:

DelVad den innehåller
database.sqliteHuvuddatabasen: bibliotek, serier, böcker, metadata, användare, läsförlopp, samlingar, läslistor och genererade miniatyrer
tasks.sqliteVäntande bakgrundsuppgifter
sessions.sqliteInloggningssessionerna, som standard sparade i databasen sedan version 1.30.0
lucene/Sökindexet
fonts/Typsnitten
logs/Loggarna, däribland komga.log
application.ymlDin konfiguration, om du har skapat en

SQLite-databaserna kopieras medan Komga är stoppat, för en konsekvent kopia. Från mappen med compose.yaml:

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

Skicka arkivet utanför servern, lika ofta som du lägger till och läser böcker. Behåll också en kopia av dina böcker, med omslagen som du sparar bredvid filerna: det är den största volymen, men den ändras lite, och rsync skickar bara det som är nytt. Sparade på serverns disk ingår dessa arkiv också i dess nattliga säkerhetskopior.

För att återställa stoppar du Komga, ersätter mappen config med den från arkivet, kontrollerar att den fortfarande ägs av användaren i compose.yaml, och startar Komga igen.

Uppdateringar

Med Docker Compose anger dokumentationen dessa kommandon, från mappen med compose.yaml. Mappen /config, monterad från servern, behåller dina inställningar:

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

Vem gör vad på en Managed VPS

Att självhosta innebär att sköta servern utöver applikationen. På en Managed VPS tar våra team hand om servern och följer din instans proaktivt; Komga förblir din programvara, med sina inställningar och dina böcker.

OmrådeVåra teamDu
ServernUppdateringar av system och säkerhet, ingrepp på servern inräknadeTidpunkten som passar din verksamhet
ÖvervakningenServern följs dygnet runt, alla dagar, med ingrepp utan att vänta på ditt samtalLäsningen av din instans loggar
KomgaProaktiv uppföljning: fel, långsamma svarstider, minne och diskutrymme upptäcks, med rekommenderad rättelseInstallationen, uppdateringarna och inställningarna, som du genomför själv eller med din AI-assistent
Biblioteken och läsarnaServern som bär dem, övervakad och säkerhetskopieradBiblioteken, kontona, rollerna och API-nycklarna
SäkerhetskopiornaVarje natt, krypterade och förvarade utanför maskinen; återställning ingårKomgas egna kopior och begäran om återställning, när du behöver den
MigreringenDin nuvarande server migreras kostnadsfrittTidpunkten för bytet

Om du föredrar att våra team ingriper i själva applikationen faktureras den tjänsten per timme eller som fast pris, med en offert som lämnas före ingreppet.

Komga, på en server som sköts åt dig

Med en Managed VPS från Simafri håller våra team servern för din Komga-instans uppdaterad, övervakar den dag och natt och griper in utan att vänta på ditt samtal; de följer också din instans proaktivt och rekommenderar de rättelser som är till nytta, som du genomför själv eller med din AI-assistent. Säkerhetskopiorna krypteras varje natt och förvaras utanför maskinen, återställningen ingår, och migreringen av din nuvarande server är kostnadsfri.

Upptäck Managed VPS

Vanliga frågor

Är Komga gratis för ett företag?

Ja. Komga är licensierat under MIT-licensen: du kan använda, ändra och vidaredistribuera det i ditt företag utan att köpa någon licens, så länge du behåller dess upphovsrättsmeddelande. Kvar blir kostnaden för servern som kör det.

Hur mycket minne behöver Komga?

Dokumentationen anger inget minimum. Som standard begränsar Java Komgas minne, oftast till omkring 1 GB. Om loggarna visar fel av typen OutOfMemoryException höjer du gränsen med JAVA_TOOL_OPTIONS, till exempel -Xmx4g för 4 GB.

Hur installerar man Komga med Docker Compose?

Skapa en compose.yaml med avbilden gotson/komga, port 25600 publicerad på 127.0.0.1, en mapp config monterad på /config, en mapp data monterad på /data och en användare som äger båda, och kör sedan docker compose up -d. Sätt därefter en omvänd proxy med HTTPS framför port 25600.

Hur skapar man administratörskontot i Komga?

Vid första besöket ber Komga om en e-postadress och ett lösenord: det första kontot får alla roller. Skapa det genom en SSH-tunnel innan du öppnar servern för allmänheten, och skapa sedan de andra kontona under Server Settings, Users.

Vilken OPDS-adress anger jag i min läsapp?

Din servers adress följd av /opds/v2/catalog för OPDS 2, eller av /opds/v1.2/catalog för OPDS 1.2, med e-postadressen och lösenordet för ditt Komga-konto.

Hur synkroniserar man en Kobo-läsplatta med Komga?

Ge kontot rollerna Kobo Sync och File Download, generera en API-nyckel under Account Settings, och ersätt sedan raden api_endpoint i filen Kobo eReader.conf med https://din-server/kobo/din-nyckel. Bara EPUB-böcker synkroniseras.

Hur säkerhetskopierar man Komga?

Stoppa Komga, arkivera mappen config, starta Komga igen och skicka arkivet utanför servern. Behåll också en kopia av dina böcker. Gör en kopia strax före varje uppdatering.

Täcker en Managed VPS Komga?

En Managed VPS täcker servern: system, säkerhet, övervakning och säkerhetskopior. Våra team följer också din instans proaktivt och rekommenderar de rättelser som är till nytta, som du genomför själv. Ett ingrepp i själva applikationen faktureras per timme eller som fast pris.

Kontakta oss