Hostovat Komga na Managed VPS: vaše komiksy a manga na vašem serveru

Hostovat Komga na Managed VPS znamená číst své komiksy, mangu a e-knihy z vlastního stroje, který naše týmy udržují aktuální a ve dne i v noci hlídají. Komga je mediální server, svobodný software pod licencí MIT. Tento průvodce sleduje její oficiální dokumentaci: paměť a úložiště, se kterými počítat, instalaci pomocí Docker Compose, první účet, konfiguraci, HTTPS, knihovny, čtení přes OPDS, Kobo a KOReader, zálohy a aktualizace.

Simon Vasconcelos Lee Autor: Publikováno 22. listopadu 2026Doba čtení: 14 minut

Všichni průvodci

To nejdůležitější

  1. Licence MIT dovoluje Komgu volně používat, upravovat a dále šířit, ve firmě i jinde, pokud zachováte její upozornění o autorských právech.
  2. Úložiště se dimenzuje podle vaší sbírky uložené v /data; databáze, index a protokoly jsou v /config, na lokálním disku.
  3. Nainstalujte ji pomocí Docker Compose: obraz gotson/komga, port 25600 publikovaný lokálně za reverzní proxy s HTTPS a uživatel, který vlastní obě složky.
  4. První vytvořený účet se stane správcem: vytvořte ho přes tunel SSH dřív, než server otevřete veřejnosti.
  5. Zastavte Komgu, zkopírujte složku /config mimo server, uchovejte kopii svých knih a aktualizujte pomocí docker compose pull.

Co dělá Komga

Komga je mediální server pro vaše komiksy, mangu, frankobelgické komiksy, časopisy a e-knihy. Nasměrujete ji na složky s vašimi soubory, ona je uspořádá do knihoven, sérií a knih a pak je zpřístupní prohlížeči nebo čtecí aplikaci. Běží všude, kde běží Java nebo Docker.

Co licence MIT dovoluje

Komga je vydávána pod licencí MIT, na jméno Gauthiera Roebroecka. Ta bezplatně uděluje právo software používat, kopírovat, upravovat, slučovat, zveřejňovat, šířit, sublicencovat a prodávat jeho kopie. Můžete ji tedy provozovat pro sebe, svou rodinu, svůj spolek nebo svou firmu, aniž byste kupovali licenci.

Jedinou podmínkou je zachovat upozornění o autorských právech a text licence ve všech kopiích nebo podstatných částech softwaru. Text poskytuje software „tak, jak je“, bez záruky.

Paměť, CPU a úložiště: dimenzování serveru

Dokumentace nestanoví žádnou minimální konfiguraci. Uvádí ale to, na čem při dimenzování serveru záleží: paměť virtuálního stroje Javy, úlohy, které využívají CPU, a především místo, které zabírají vaše soubory.

Paměť Javy

CPU

CPU pracuje hlavně při skenování a analýze knihoven. U každé knihovny dokumentace upozorňuje, že výpočet hashů souborů, hashů stránek a hashů pro KOReader, stejně jako analýza rozměrů stránek, může u velké knihovny spotřebovat hodně prostředků. Počet vláken vyhrazených pro úlohy na pozadí se nastavuje v „Server Settings“.

Úložiště pro vaše knihy

To je největší položka a změříte ji sami: velikost vaší sbírky plus rezerva pro knihy, které plánujete přidat. Komga čte vaše soubory tam, kde jsou, a nekopíruje je. Několik bodů z dokumentace mění výpočet:

Na Managed VPS nám stačí popsat vaši sbírku, její velikost, tempo růstu a počet čtenářů, a doporučíme vám vhodnou velikost.

Instalace pomocí Docker Compose

Dokumentace publikuje obraz gotson/komga na Docker Hubu a na ghcr.io, pro procesory amd64, arm64 a arm. Na serveru s nainstalovaným Dockerem vytvořte pro Komgu složku s jejími dvěma podsložkami a poznamenejte si své ID uživatele:

Terminál
mkdir -p ~/komga/config ~/komga/data/import
cd ~/komga
id

Vložte do ní tento compose.yaml, převzatý z příkladu v dokumentaci. Nahraďte 1000:1000 hodnotami uid a gid, které vypíše id, a TZ svým časovým pásmem:

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
Terminál
docker compose up -d
docker logs -f komga

Bez Dockeru: soubor jar

Druhá cesta z dokumentace pro linuxový server je soubor jar každého vydání, publikovaný na GitHubu. Vyžaduje Javu 17 nebo novější a svou konfiguraci uchovává v ~/.komga:

Terminál
java -version
java -jar komga-1.30.1.jar

První účet a uživatelé

Při prvním přístupu vás Komga vyzve k vytvoření účtu: e-mailové adresy a hesla. Tento první účet dostane všechny role, včetně správy, a „zabere“ server. Dokud neexistuje, odpovídá tento formulář každému, kdo se na stránku dostane: vytvořte ho přes tunel SSH dřív, než server otevřete veřejnosti. Port 25600 serveru se pak objeví na vašem počítači, na http://localhost:25600. Přidejte -p a port SSH uvedený ve vašem zákaznickém prostoru.

Terminál, na vašem počítači
ssh -L 25600:127.0.0.1:25600 user@komga.example.com

Další účty vytváří správce v „Server Settings“, „Users“, tlačítkem +. Každý účet dostane role, které potřebuje:

RoleCo umožňuje
AdministratorSpráva knihoven, uživatelů a kolekcí, úprava metadat, spouštění skenování, analýzy a obnovy metadat
Page StreamingČtení stránku po stránce, například ve webové čtečce
File DownloadStažení souboru knihy
Kobo SyncSynchronizace čtečky Kobo, spolu s File Download
KOReader SyncSynchronizace postupu čtení s KOReader

Smazání uživatele nevratně vymaže celý jeho postup čtení: kopie /config pořízená těsně předtím vám ponechá kontrolu.

Obnovení hesla z příkazového řádku

Dokumentace přidává příkaz do compose.yaml, pod službu komga; Komga změnu provede a pak se spustí jako obvykle. Restartujte službu, potom řádek odeberte a restartujte ji ještě jednou:

compose.yaml, pod službou komga
    command: --newpassword=YourNewPassword --reset=admin@example.org
Terminál
docker compose up -d

Příkaz --list-users, použitý stejným způsobem, vypíše seznam účtů do protokolů.

Konfigurace: proměnné nebo application.yml

Komga má výchozí hodnoty pro každé nastavení: konfigurace jen mění její chování. Provádí se proměnnými prostředí, což je s Docker Compose nejjednodušší cesta, nebo souborem application.yml, který vytvoříte ve složce /config, odkud ho obraz Docker načte. Chcete-li název vlastnosti převést na název proměnné, nahraďte tečky podtržítky, odstraňte pomlčky a převeďte vše na velká písmena.

ProměnnáVlastnostVýchozí hodnotaK čemu slouží
SERVER_PORTserver.port25600Port pro API a webové rozhraní
SERVER_SERVLET_CONTEXTPATHserver.servlet.context-path/Základní URL, pro provoz Komgy v podsložce
SPRING_SESSION_TIMEOUTspring.session.timeout7 dníJak dlouho trvá neaktivní relace, například 14d nebo 24h
KOMGA_CORS_ALLOWEDORIGINSkomga.cors.allowed-originsŽádnáPůvody (origins) povolené pro CORS
LOGGING_LEVEL_ORG_GOTSON_KOMGAlogging.level.org.gotson.komgaNenastavenoDEBUG pro podrobné protokoly

Port a základní URL lze nastavit i v „Server Settings“, a toto nastavení pak má přednost před konfigurací. Pro paměť Javy přidejte proměnnou JAVA_TOOL_OPTIONS do sekce environment. Příklad v dokumentaci nastavuje maximum 4 GB:

compose.yaml, v sekci environment
      - JAVA_TOOL_OPTIONS=-Xmx4g

Vzorový application.yml v dokumentaci začíná cestou k databázi. S Dockerem ji ponechte na /config/database.sqlite, její výchozí hodnotě: kdekoli jinde by se databáze vytvořila uvnitř kontejneru a při jeho opětovném vytvoření by se ztratila. Ze vzoru si ponechte jen řádky, které potřebujete.

HTTPS a reverzní proxy

Dokumentace doporučuje umístit před Komgu reverzní proxy, která získá platný certifikát, a navrhuje Caddy, který si sám generuje certifikáty Let’s Encrypt. Proxy musí nastavit tři hlavičky, aby Komga znala veřejnou adresu a protokol každého požadavku:

S Caddy

Na subdoméně, bez základní URL v nastavení Komgy, nastaví Caddy tyto hlavičky sám:

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

V podsložce nejprve nastavte základní URL Komgy na /komga, v „Server Settings“ nebo proměnnou SERVER_SERVLET_CONTEXTPATH, a potom:

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

S Nginx

Příklad pro Nginx v dokumentaci předává i spojení WebSocket. Přidejte tento blok map do sekce http souboru /etc/nginx/nginx.conf:

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

Tento blok webu používá nastavení z příkladu v dokumentaci, na portu 80, aby Certbot mohl nastavit HTTPS. Řádek X-Forwarded-Host je přidán, protože ho vyžaduje seznam hlaviček v dokumentaci:

Blok Nginx
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;
    }
}
Terminál
sudo nginx -t
sudo certbot --nginx

Úplný příklad v dokumentaci ukazuje konečnou verzi: port 80 přesměrovaný na HTTPS a blok na portu 443 s cestami k certifikátu.

Knihovny, skenování a importy

Knihovna je skupina knih uložená pod kořenovou složkou. Komga vytvoří sérii pro každou podsložku, v libovolné hloubce, a knihu pro každý soubor, zařazenou do série jeho nadřazené složky. Metadata ze souborů EPUB a ze souborů ComicInfo.xml uvnitř archivů mají přednost před názvy složek a souborů.

  1. Umístěte soubory na server, do jedné podsložky ~/komga/data pro každou knihovnu, přes SFTP nebo pomocí rsync.
  2. V rozhraní klikněte na + vedle „Libraries“.
  3. Pojmenujte knihovnu, vyberte její kořenovou složku tlačítkem „Browse“, například /data/manga, a klikněte na „Add“.
Terminál, na vašem počítači
rsync -av manga/ user@komga.example.com:komga/data/manga/

Koš

Kniha, jejíž soubor zmizí, se místo smazání přesune do koše s označením „Unavailable“: její metadata, postup čtení a seznamy se vrátí, pokud se soubor znovu objeví na svém místě. Své soubory tedy můžete přejmenovávat a přesouvat, aniž byste o cokoli přišli. Koš se vyprazdňuje ručně, nebo po každém skenování, pokud tuto volbu zapnete, a ta pak položky odstraňuje okamžitě.

Import knih

Obrazovka „Import“, „Books“ zařadí do vašich sérií knihy, které leží v jiné složce serveru, například /data/import. U každého souboru zvolíte cílovou sérii, číslo a název; už použité číslo nabídne nahrazení stávající knihy novější verzí, přičemž obě se zobrazí vedle sebe. Komga soubory přesune, nebo na ně vytvoří pevné odkazy, když to souborový systém dovolí, a jinak je zkopíruje.

Změna kořenové složky knihovny na cestu, která se starou nesouvisí, vymaže její série, knihy a postup čtení. FAQ popisuje, jak ji přesunout: hashování souborů zapnuté, automatické vyprazdňování koše vypnuté a pak skenování před přesunem.

Čtení kdekoli: OPDS, Kobo a KOReader

Webová čtečka se otevře v prohlížeči, na adrese serveru. Pro aplikaci nebo čtečku e-knih nabízí Komga troje dveře, všechny k provozu přes HTTPS.

OPDS

Komga funguje s jakoukoli aplikací OPDS, verze 1 nebo 2. Zadejte aplikaci jednu z těchto adres a potom e-mailovou adresu a heslo svého účtu Komga:

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

Katalog verze 1.2 přidává vyhledávání podle sérií, přes OpenSearch, a čtení stránku po stránce bez stahování, přes rozšíření OPDS PSE. Dokumentace vede seznam otestovaných aplikací pro Android, iOS i jiné platformy, s tím, co každá podporuje.

Kobo Sync

Vaše čtečka Kobo se synchronizuje s Komgou místo s oficiálními servery Kobo. Knihy EPUB ze všech knihoven přicházejí s metadaty a obálkou, za běhu převedené na KEPUB nástrojem Kepubify, který je součástí obrazu Docker. Postup čtení se synchronizuje oběma směry.

  1. Přidělte účtu role Kobo Sync a File Download.
  2. Vygenerujte klíč API na stránce svého účtu, „Account Settings“, a poznamenejte si ho: zobrazí se jen jednou. Používejte jeden klíč na čtečku.
  3. Připojte Kobo k počítači a otevřete soubor .kobo/Kobo/Kobo eReader.conf, se zobrazenými skrytými soubory.
  4. Ve skupině [OneStoreServices] nahraďte řádek api_endpoint adresou svého serveru, za kterou následuje váš klíč.
Kobo eReader.conf
api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY

KOReader Sync

KOReader čte Komgu přes OPDS a svůj postup čtení synchronizuje přes synchronizační server Komgy:

  1. Přidělte účtu roli KOReader Sync a v možnostech knihovny zapněte hashování souborů pro KOReader.
  2. Vygenerujte klíč API na stránce svého účtu.
  3. V KOReaderu s otevřenou knihou přejděte do „Progress sync“, potom „Custom sync server“, a zadejte https://komga.example.com/koreader.
  4. V „Register / Login“ zadejte klíč API jako uživatelské jméno a jako heslo libovolnou hodnotu, kterou Komga nepoužívá.
  5. V „Document matching method“ zvolte „Binary“.

Zálohy

Vše, co Komga ví o vašich knihách, je v /config; samotné knihy zůstávají v /data. Toto obsahuje /config při výchozí konfiguraci:

PoložkaCo obsahuje
database.sqliteHlavní databáze: knihovny, série, knihy, metadata, uživatelé, postup čtení, kolekce, seznamy četby a vygenerované náhledy
tasks.sqliteČekající úlohy na pozadí
sessions.sqlitePřihlašovací relace, od verze 1.30.0 ve výchozím stavu ukládané v databázi
lucene/Vyhledávací index
fonts/Písma
logs/Protokoly, včetně komga.log
application.ymlVaše konfigurace, pokud jste ji vytvořili

Databáze SQLite se kopírují při zastavené službě Komga, aby kopie byla konzistentní. Ze složky se souborem compose.yaml:

Terminál, v ~/komga
docker compose stop
tar -czf komga-config-$(date +%F).tar.gz config
docker compose start

Posílejte tento archiv mimo server tak často, jak přidáváte a čtete knihy. Uchovávejte také kopii svých knih, včetně obálek, které máte vedle souborů: je to největší objem, ale mění se málo a rsync posílá jen to, co je nové. Uložené na disku serveru se tyto archivy dostanou i do jeho nočních záloh.

Pro obnovu Komgu zastavte, nahraďte složku config složkou z archivu, zkontrolujte, že ji stále vlastní uživatel z compose.yaml, a znovu ji spusťte.

Aktualizace

S Docker Compose dokumentace uvádí tyto příkazy, spouštěné ze složky se souborem compose.yaml. Složka /config, připojená ze serveru, zachová vaše nastavení:

Terminál
docker compose pull
docker compose up -d
docker image prune

Kdo co dělá na Managed VPS

Vlastní hosting vyžaduje, abyste kromě aplikace udržovali i server. Na Managed VPS se serveru ujímají naše týmy a vaši instanci proaktivně sledují; Komga zůstává vaším softwarem, s jejím nastavením a vašimi knihami.

TémaNaše týmyVy
ServerAktualizace systému a zabezpečení, včetně zásahů na serveruOkamžik, který vyhovuje vašemu provozu
DohledServer sledovaný 24 hodin denně, 7 dní v týdnu, se zásahem bez čekání na vaše voláníČtení protokolů vaší instance
KomgaProaktivní sledování: chyby, zpomalení, paměť a místo na disku zachycené, doporučená opravaJejí instalace, aktualizace a nastavení, které zapracujete vy nebo váš AI asistent
Knihovny a čtenářiServer, který je nese, hlídaný a zálohovanýKnihovny, účty, role a klíče API
ZálohyKaždou noc, šifrované a uchovávané mimo stroj; obnova v ceněVlastní kopie Komgy a žádost o obnovu, když ji potřebujete
MigraceVáš stávající server přenesen zdarmaOkamžik přepnutí

Pokud dáváte přednost tomu, aby naše týmy zasáhly přímo v aplikaci, tato služba se účtuje po hodinách nebo paušálem, s cenovou nabídkou sdělenou před zásahem.

Komga na serveru, o který se staráme za vás

S Managed VPS od Simafri udržují naše týmy server vaší instance Komga aktuální, hlídají ho ve dne i v noci a zasahují bez čekání na vaše volání; vaši instanci také proaktivně sledují a doporučí vám užitečné opravy, které zapracujete vy nebo váš AI asistent. Zálohy se každou noc šifrují a uchovávají mimo stroj, jejich obnova je v ceně a migrace vašeho stávajícího serveru je zdarma.

Objevit Managed VPS

Časté otázky

Je Komga pro firmu zdarma?

Ano. Komga je pod licencí MIT: můžete ji ve firmě používat, upravovat a dále šířit, aniž byste kupovali licenci, pokud zachováte její upozornění o autorských právech. Zbývají náklady na server, na kterém běží.

Kolik paměti Komga potřebuje?

Dokumentace nestanoví žádné minimum. Ve výchozím stavu Java omezuje paměť Komgy, obvykle zhruba na 1 GB. Pokud protokoly ukazují chyby OutOfMemoryException, zvyšte limit pomocí JAVA_TOOL_OPTIONS, například -Xmx4g pro 4 GB.

Jak nainstalovat Komgu pomocí Docker Compose?

Vytvořte compose.yaml s obrazem gotson/komga, portem 25600 publikovaným na 127.0.0.1, složkou config připojenou na /config, složkou data připojenou na /data a uživatelem, který obě vlastní, a spusťte docker compose up -d. Potom před port 25600 umístěte reverzní proxy s HTTPS.

Jak vytvořit účet správce Komgy?

Při prvním přístupu Komga požádá o e-mailovou adresu a heslo: tento první účet dostane všechny role. Vytvořte ho přes tunel SSH dřív, než server otevřete veřejnosti, a další účty pak vytvářejte v Server Settings, Users.

Jakou adresu OPDS zadat čtecí aplikaci?

Adresu svého serveru, za kterou následuje /opds/v2/catalog pro OPDS 2, nebo /opds/v1.2/catalog pro OPDS 1.2, spolu s e-mailovou adresou a heslem svého účtu Komga.

Jak synchronizovat čtečku Kobo s Komgou?

Přidělte účtu role Kobo Sync a File Download, vygenerujte klíč API v Account Settings a pak nahraďte řádek api_endpoint v souboru Kobo eReader.conf adresou https://your-server/kobo/your-key. Synchronizují se jen knihy EPUB.

Jak zálohovat Komgu?

Zastavte Komgu, archivujte složku config, znovu ji spusťte a archiv pošlete mimo server. Uchovávejte také kopii svých knih. Kopii si pořiďte i těsně před každou aktualizací.

Pokrývá Managed VPS i Komgu?

Managed VPS pokrývá server: systém, zabezpečení, dohled a zálohy. Naše týmy také proaktivně sledují vaši instanci a doporučí vám užitečné opravy, které zapracujete vy. Zásah v samotné aplikaci se účtuje po hodinách nebo paušálem.

Kontaktujte nás