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.
Autor: Simon Vasconcelos Lee
Publikováno 22. listopadu 2026Doba čtení: 14 minut
/data; databáze, index a protokoly jsou v /config, na lokálním disku.gotson/komga, port 25600 publikovaný lokálně za reverzní proxy s HTTPS a uživatel, který vlastní obě složky./config mimo server, uchovejte kopii svých knih a aktualizujte pomocí docker compose pull.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.
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.
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.
OutOfMemoryException v protokolech. Limit se pak zvýší proměnnou JAVA_TOOL_OPTIONS, uvedenou níže.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“.
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:
/data pro knihy i importy: dokumentace žádá, abyste do ní umístili své knihovny i složku pro import, aby importy vytvářely pevné odkazy místo kopií. Mimo tentýž souborový systém zabere každý import místo kopie./config obsahuje hlavní databázi s náhledy vygenerovanými pro každou knihu, databázi úloh, databázi relací, vyhledávací index a protokoly, které výchozí konfigurace uchovává 7 dní a omezuje na 1 GB. Roste s velikostí vašich knihoven./config: databáze SQLite nesmějí nikdy ležet na síťovém sdílení, jako je CIFS nebo NFS. Komga to kontroluje při spuštění, a pokud tomu tak není, zastaví se.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.
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:
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:
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: to je hlavní odchylka od příkladu v dokumentaci, který ho publikuje na všech adresách. Dokumentace důrazně doporučuje HTTPS, jakmile je Komga otevřena mimo vaši místní síť, protože používá základní ověřování HTTP (basic). Rozhraní je pak dostupné jen přes reverzní proxy.user. Dokumentace žádá, aby připojené složky vlastnil tentýž uživatel: problémy s oprávněními pak zmizí./config obsahuje databázi a konfiguraci Komgy, na lokálním disku./data obsahuje vaše knihy a vaši složku pro import. Každá knihovna v ní bude mít vlastní podsložku.1.x sleduje nejnovější publikovanou verzi 1; 1.30.1 verzi pevně určí. Dokumentace popisuje latest jako nejnovější commit.version z příkladu v dokumentaci je vynechán: Docker Compose ho nyní považuje za zastaralý a ignoruje ho.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:
java -version
java -jar komga-1.30.1.jar
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.
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:
| Role | Co umožňuje |
|---|---|
| Administrator | Sprá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 Download | Stažení souboru knihy |
| Kobo Sync | Synchronizace čtečky Kobo, spolu s File Download |
| KOReader Sync | Synchronizace 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.
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:
command: --newpassword=YourNewPassword --reset=admin@example.org
docker compose up -d
Příkaz --list-users, použitý stejným způsobem, vypíše seznam účtů do protokolů.
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á | Vlastnost | Výchozí hodnota | K čemu slouží |
|---|---|---|---|
SERVER_PORT | server.port | 25600 | Port pro API a webové rozhraní |
SERVER_SERVLET_CONTEXTPATH | server.servlet.context-path | / | Základní URL, pro provoz Komgy v podsložce |
SPRING_SESSION_TIMEOUT | spring.session.timeout | 7 dní | Jak dlouho trvá neaktivní relace, například 14d nebo 24h |
KOMGA_CORS_ALLOWEDORIGINS | komga.cors.allowed-origins | Žádná | Původy (origins) povolené pro CORS |
LOGGING_LEVEL_ORG_GOTSON_KOMGA | logging.level.org.gotson.komga | Nenastaveno | DEBUG 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:
- 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.
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:
X-Forwarded-For, nastavená nebo doplněná;X-Forwarded-Proto;X-Forwarded-Host.Na subdoméně, bez základní URL v nastavení Komgy, nastaví Caddy tyto hlavičky sám:
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:
example.com {
reverse_proxy /komga/* 127.0.0.1:25600
}
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:
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:
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
Ú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.
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ů.
~/komga/data pro každou knihovnu, přes SFTP nebo pomocí rsync./data/manga, a klikněte na „Add“.rsync -av manga/ user@komga.example.com:komga/data/manga/
/data/manga a /data/comics existují vedle sebe; /data a /data/manga nemohou.#recycle.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ě.
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.
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.
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:
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.
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.
.kobo/Kobo/Kobo eReader.conf, se zobrazenými skrytými soubory.[OneStoreServices] nahraďte řádek api_endpoint adresou svého serveru, za kterou následuje váš klíč.api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY
api_endpoint, 443 pro adresu HTTPS.KOReader čte Komgu přes OPDS a svůj postup čtení synchronizuje přes synchronizační server Komgy:
https://komga.example.com/koreader.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žka | Co obsahuje |
|---|---|
database.sqlite | Hlavní 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.sqlite | Př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.yml | Vaš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:
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.
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í:
docker compose pull
docker compose up -d
docker image prune
/config.jar Komgu zastavte a pak ji spusťte souborem jar nové verze.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éma | Naše týmy | Vy |
|---|---|---|
| Server | Aktualizace systému a zabezpečení, včetně zásahů na serveru | Okamžik, který vyhovuje vašemu provozu |
| Dohled | Server sledovaný 24 hodin denně, 7 dní v týdnu, se zásahem bez čekání na vaše volání | Čtení protokolů vaší instance |
| Komga | Proaktivní sledování: chyby, zpomalení, paměť a místo na disku zachycené, doporučená oprava | Její instalace, aktualizace a nastavení, které zapracujete vy nebo váš AI asistent |
| Knihovny a čtenáři | Server, který je nese, hlídaný a zálohovaný | Knihovny, účty, role a klíče API |
| Zálohy | Každou noc, šifrované a uchovávané mimo stroj; obnova v ceně | Vlastní kopie Komgy a žádost o obnovu, když ji potřebujete |
| Migrace | Váš stávající server přenesen zdarma | Okamž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.
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.
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ěží.
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.
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.
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.
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.
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.
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í.
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.
Simafri
Promluvme si o vašem záměru
Řekněte nám v pár slovech, co potřebujete: rychle se vám ozveme.
Děkujeme! Vaše zpráva byla odeslána. Brzy se vám ozveme.
Máte raději e-mail? Napište nám na support@simafri.com.