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.
Av Simon Vasconcelos Lee
Publicerad den 22 november 2026Lästid: 14 minuter
/data; databasen, indexet och loggarna ligger i /config, på en lokal disk.gotson/komga, port 25600 publicerad lokalt bakom en omvänd proxy med HTTPS, och en användare som äger båda mapparna./config utanför servern, behåll en kopia av dina böcker och uppdatera med docker compose pull.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.
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.
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.
OutOfMemoryException i loggarna. Gränsen höjs då med variabeln JAVA_TOOL_OPTIONS, som visas längre ned.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”.
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:
/data för böcker och importer: dokumentationen ber dig lägga dina bibliotek och din importmapp där, så att importer skapar hårda länkar i stället för kopior. Utanför samma filsystem tar varje import samma plats som en kopia./config innehåller huvuddatabasen, med miniatyrerna som genereras för varje bok, uppgiftsdatabasen, sessionsdatabasen, sökindexet och loggarna, som standardkonfigurationen sparar i 7 dagar och begränsar till 1 GB. Den växer med storleken på dina bibliotek./config: SQLite-databaserna får aldrig ligga på en nätverksresurs som CIFS eller NFS. Komga kontrollerar detta vid start och stannar om så inte är fallet.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.
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:
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:
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 är den viktigaste avvikelsen från dokumentationens exempel, som publicerar den på alla adresser. Dokumentationen rekommenderar starkt HTTPS så snart Komga öppnas utanför ditt lokala nätverk, eftersom det använder HTTP basic-autentisering. Gränssnittet nås då bara genom den omvända proxyn.user. Dokumentationen ber att de monterade mapparna ägs av samma användare: då försvinner problemen med behörigheter./config innehåller Komgas databas och konfiguration, på en lokal disk./data innehåller dina böcker och din importmapp. Varje bibliotek får sin egen undermapp där.1.x följer den senast publicerade versionen 1; 1.30.1 låser en version. Dokumentationen beskriver latest som den senaste committen.version i dokumentationens exempel är utelämnad: Docker Compose betraktar den nu som föråldrad och ignorerar den.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:
java -version
java -jar komga-1.30.1.jar
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.
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:
| Roll | Vad den tillåter |
|---|---|
| Administrator | Hantera bibliotek, användare och samlingar, redigera metadata, starta skanningar, analyser och uppdateringar av metadata |
| Page Streaming | Läsa sida för sida, till exempel i läsaren på webben |
| File Download | Ladda ned filen för en bok |
| Kobo Sync | Synkronisera en Kobo-läsplatta, tillsammans med File Download |
| KOReader Sync | Synkronisera 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.
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:
command: --newpassword=YourNewPassword --reset=admin@example.org
docker compose up -d
Kommandot --list-users, använt på samma sätt, skriver listan över konton i loggarna.
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.
| Variabel | Egenskap | Standard | Vad den gör |
|---|---|---|---|
SERVER_PORT | server.port | 25600 | Porten för API:et och webbgränssnittet |
SERVER_SERVLET_CONTEXTPATH | server.servlet.context-path | / | Bas-URL:en, för att servera Komga från en undermapp |
SPRING_SESSION_TIMEOUT | spring.session.timeout | 7 dagar | Hur länge en inaktiv session varar, till exempel 14d eller 24h |
KOMGA_CORS_ALLOWEDORIGINS | komga.cors.allowed-origins | Inga | Ursprungen som tillåts för CORS |
LOGGING_LEVEL_ORG_GOTSON_KOMGA | logging.level.org.gotson.komga | Inte angiven | DEBUG 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:
- 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.
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:
X-Forwarded-For, satt eller utökat;X-Forwarded-Proto;X-Forwarded-Host.På en underdomän, utan bas-URL i Komga, sätter Caddy själv dessa huvuden:
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:
example.com {
reverse_proxy /komga/* 127.0.0.1:25600
}
Dokumentationens Nginx-exempel vidarebefordrar också WebSocket-anslutningar. Lägg till detta block map i avsnittet http i /etc/nginx/nginx.conf:
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:
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 fullständiga exempel visar den slutliga versionen: port 80 omdirigerad till HTTPS, och blocket på 443 med sökvägarna till certifikatet.
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.
~/komga/data per bibliotek, via SFTP eller med rsync./data/manga, och klicka sedan på ”Add”.rsync -av manga/ user@komga.example.com:komga/data/manga/
/data/manga och /data/comics ligger sida vid sida; /data och /data/manga går inte.#recycle.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.
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ä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.
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:
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.
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.
.kobo/Kobo/Kobo eReader.conf, med dolda filer visade.[OneStoreServices] ersätter du raden api_endpoint med din servers adress följd av din nyckel.api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY
api_endpoint, 443 för en HTTPS-adress.KOReader läser Komga via OPDS och synkroniserar sitt läsförlopp genom Komgas synkroniseringsserver:
https://komga.example.com/koreader.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:
| Del | Vad den innehåller |
|---|---|
database.sqlite | Huvuddatabasen: bibliotek, serier, böcker, metadata, användare, läsförlopp, samlingar, läslistor och genererade miniatyrer |
tasks.sqlite | Väntande bakgrundsuppgifter |
sessions.sqlite | Inloggningssessionerna, som standard sparade i databasen sedan version 1.30.0 |
lucene/ | Sökindexet |
fonts/ | Typsnitten |
logs/ | Loggarna, däribland komga.log |
application.yml | Din konfiguration, om du har skapat en |
SQLite-databaserna kopieras medan Komga är stoppat, för en konsekvent kopia. Från mappen med compose.yaml:
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.
Med Docker Compose anger dokumentationen dessa kommandon, från mappen med compose.yaml. Mappen /config, monterad från servern, behåller dina inställningar:
docker compose pull
docker compose up -d
docker image prune
/config strax före varje uppdatering.jar-filen stoppar du Komga och startar det sedan med jar-filen för den nya versionen.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åde | Våra team | Du |
|---|---|---|
| Servern | Uppdateringar av system och säkerhet, ingrepp på servern inräknade | Tidpunkten som passar din verksamhet |
| Övervakningen | Servern följs dygnet runt, alla dagar, med ingrepp utan att vänta på ditt samtal | Läsningen av din instans loggar |
| Komga | Proaktiv uppföljning: fel, långsamma svarstider, minne och diskutrymme upptäcks, med rekommenderad rättelse | Installationen, uppdateringarna och inställningarna, som du genomför själv eller med din AI-assistent |
| Biblioteken och läsarna | Servern som bär dem, övervakad och säkerhetskopierad | Biblioteken, kontona, rollerna och API-nycklarna |
| Säkerhetskopiorna | Varje natt, krypterade och förvarade utanför maskinen; återställning ingår | Komgas egna kopior och begäran om återställning, när du behöver den |
| Migreringen | Din nuvarande server migreras kostnadsfritt | Tidpunkten 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Simafri
Låt oss prata om din webbplats
Berätta om ditt projekt med några ord: vi återkommer snabbt.
Tack! Din förfrågan har skickats. Vi återkommer till dig inom kort.
Föredrar du e-post? Skriv till oss på support@simafri.com.