Hostovanie Komga na Managed VPS znamená čítať svoje komiksy, mangy a e-knihy z vlastného stroja, ktorý naše tímy udržiavajú aktuálny a dohliadajú naň vo dne v noci. Komga je mediálny server, slobodný softvér pod licenciou MIT. Tento sprievodca postupuje podľa jej oficiálnej dokumentácie: pamäť a úložisko, s ktorými treba počítať, inštalácia cez Docker Compose, prvý účet, konfigurácia, HTTPS, knižnice, čítanie cez OPDS, Kobo a KOReader, zálohy a aktualizácie.
Autor: Simon Vasconcelos Lee
Publikované 22. novembra 2026Čas čítania: 14 minút
/data; databáza, index a záznamy sú v /config, na lokálnom disku.gotson/komga, port 25600 publikovaný lokálne za reverznou proxy s HTTPS a používateľ, ktorý vlastní oba priečinky./config mimo servera, uchovajte kópiu svojich kníh a aktualizujte príkazom docker compose pull.Komga je mediálny server pre vaše komiksy, mangy, frankobelgické komiksy, časopisy a e-knihy. Nasmerujete ju na priečinky s vašimi súbormi, ona ich usporiada do knižníc, sérií a kníh a potom ich sprístupní prehliadaču alebo čitateľskej aplikácii. Beží všade, kde beží Java alebo Docker.
Komga vychádza pod licenciou MIT, na meno Gauthiera Roebroecka. Bezplatne udeľuje právo používať, kopírovať, upravovať, zlučovať, zverejňovať, šíriť, poskytovať sublicencie a predávať kópie softvéru. Môžete ju teda prevádzkovať pre seba, svoju rodinu, svoje združenie alebo svoju firmu bez licencie, ktorú by ste museli kupovať.
Jedinou podmienkou je zachovať upozornenie o autorských právach a text licencie vo všetkých kópiách alebo podstatných častiach softvéru. Text poskytuje softvér „tak, ako je“, bez záruky.
Dokumentácia neurčuje žiadnu minimálnu konfiguráciu. Uvádza však to, na čom pri dimenzovaní servera záleží: pamäť virtuálneho stroja Javy, úlohy, ktoré využívajú procesor, a predovšetkým miesto, ktoré zaberajú vaše súbory.
OutOfMemoryException v záznamoch. Limit sa potom zvýši premennou JAVA_TOOL_OPTIONS, uvedenou nižšie.Procesor pracuje hlavne pri skenovaní a analýze knižníc. Pri každej knižnici dokumentácia upozorňuje, že výpočet hashov súborov, hashov strán a hashov pre KOReader, rovnako ako analýza rozmerov strán, môže pri veľkej knižnici spotrebovať veľa prostriedkov. Počet vlákien vyhradených pre úlohy na pozadí sa nastavuje v „Server Settings“.
Je to najväčšia položka a zmeriate ju sami: veľkosť vašej zbierky plus rezerva na knihy, ktoré plánujete pridať. Komga číta vaše súbory tam, kde sú, a nekopíruje ich. Niekoľko bodov z dokumentácie mení výpočet:
/data pre knihy aj importy: dokumentácia žiada, aby ste doň umiestnili svoje knižnice aj priečinok na import, aby importy vytvárali pevné odkazy namiesto kópií. Mimo toho istého súborového systému zaberie každý import miesto kópie./config obsahuje hlavnú databázu s náhľadmi vygenerovanými pre každú knihu, databázu úloh, databázu relácií, vyhľadávací index a záznamy, ktoré predvolená konfigurácia uchováva 7 dní a obmedzuje na 1 GB. Rastie s veľkosťou vašich knižníc./config: databázy SQLite nesmú nikdy ležať na sieťovom zdieľaní, ako je CIFS alebo NFS. Komga to kontroluje pri spustení, a ak to tak nie je, zastaví sa.Na Managed VPS nám stačí opísať vašu zbierku, jej veľkosť, tempo rastu a počet čitateľov, a odporučíme vám vhodnú veľkosť.
Dokumentácia publikuje obraz gotson/komga na Docker Hube a na ghcr.io, pre procesory amd64, arm64 a arm. Na serveri s nainštalovaným Dockerom vytvorte pre Komgu priečinok s jeho dvoma podpriečinkami a poznačte si svoje ID používateľa:
mkdir -p ~/komga/config ~/komga/data/import
cd ~/komga
id
Vložte doň tento compose.yaml, prevzatý z príkladu v dokumentácii. Nahraďte 1000:1000 hodnotami uid a gid, ktoré vypíše id, a TZ svojím časovým pásmom:
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á odchýlka od príkladu v dokumentácii, ktorý ho publikuje na všetkých adresách. Dokumentácia dôrazne odporúča HTTPS, len čo je Komga otvorená mimo vašej lokálnej siete, pretože používa základné overovanie HTTP (basic). Rozhranie je potom dostupné len cez reverznú proxy.user. Dokumentácia žiada, aby pripojené priečinky vlastnil ten istý používateľ: problémy s oprávneniami potom zmiznú./config obsahuje databázu a konfiguráciu Komgy, na lokálnom disku./data obsahuje vaše knihy a váš priečinok na import. Každá knižnica v ňom bude mať vlastný podpriečinok.1.x sleduje najnovšiu publikovanú verziu 1; 1.30.1 verziu pevne určí. Dokumentácia opisuje latest ako najnovší commit.version z príkladu v dokumentácii je vynechaný: Docker Compose ho teraz považuje za zastaraný a ignoruje ho.Druhá cesta z dokumentácie pre linuxový server je súbor jar každého vydania, publikovaný na GitHube. Vyžaduje Javu 17 alebo novšiu a svoju konfiguráciu uchováva v ~/.komga:
java -version
java -jar komga-1.30.1.jar
Pri prvom prístupe vás Komga vyzve na vytvorenie účtu: e-mailovej adresy a hesla. Tento prvý účet dostane všetky roly, vrátane správy, a „zaberie“ server. Kým neexistuje, tento formulár odpovedá každému, kto sa na stránku dostane: vytvorte ho cez tunel SSH skôr, než server otvoríte verejnosti. Port 25600 servera sa potom zobrazí na vašom počítači, na http://localhost:25600. Pridajte -p a port SSH uvedený vo vašej zákazníckej zóne.
ssh -L 25600:127.0.0.1:25600 user@komga.example.com
Ďalšie účty vytvára správca v „Server Settings“, „Users“, tlačidlom +. Každý účet dostane roly, ktoré potrebuje:
| Rola | Čo umožňuje |
|---|---|
| Administrator | Správa knižníc, používateľov a kolekcií, úprava metadát, spúšťanie skenovania, analýzy a obnovy metadát |
| Page Streaming | Čítanie stranu po strane, napríklad vo webovej čítačke |
| File Download | Stiahnutie súboru knihy |
| Kobo Sync | Synchronizácia čítačky Kobo, spolu s File Download |
| KOReader Sync | Synchronizácia postupu čítania s KOReader |
Odstránenie používateľa nevratne vymaže celý jeho postup čítania: kópia /config vytvorená tesne predtým vám ponechá kontrolu.
Dokumentácia pridáva príkaz do compose.yaml, pod službu komga; Komga zmenu vykoná a potom sa spustí ako zvyčajne. Reštartujte službu, potom riadok odstráňte a reštartujte ju ešte raz:
command: --newpassword=YourNewPassword --reset=admin@example.org
docker compose up -d
Príkaz --list-users, použitý rovnakým spôsobom, vypíše zoznam účtov do záznamov.
Komga má predvolené hodnoty pre každé nastavenie: konfigurácia len mení jej správanie. Robí sa premennými prostredia, čo je s Docker Compose najjednoduchšia cesta, alebo súborom application.yml, ktorý vytvoríte v priečinku /config, odkiaľ ho obraz Docker načíta. Ak chcete názov vlastnosti previesť na názov premennej, nahraďte bodky podčiarkovníkmi, odstráňte pomlčky a všetko prepíšte veľkými písmenami.
| Premenná | Vlastnosť | Predvolená hodnota | Na čo slúži |
|---|---|---|---|
SERVER_PORT | server.port | 25600 | Port pre API a webové rozhranie |
SERVER_SERVLET_CONTEXTPATH | server.servlet.context-path | / | Základná URL, na prevádzku Komgy v podpriečinku |
SPRING_SESSION_TIMEOUT | spring.session.timeout | 7 dní | Ako dlho trvá neaktívna relácia, napríklad 14d alebo 24h |
KOMGA_CORS_ALLOWEDORIGINS | komga.cors.allowed-origins | Žiadna | Pôvody (origins) povolené pre CORS |
LOGGING_LEVEL_ORG_GOTSON_KOMGA | logging.level.org.gotson.komga | Nenastavené | DEBUG pre podrobné záznamy |
Port a základnú URL možno nastaviť aj v „Server Settings“, a toto nastavenie potom má prednosť pred konfiguráciou. Pre pamäť Javy pridajte premennú JAVA_TOOL_OPTIONS do sekcie environment. Príklad v dokumentácii nastavuje maximum 4 GB:
- JAVA_TOOL_OPTIONS=-Xmx4g
Vzorový application.yml v dokumentácii začína cestou k databáze. S Dockerom ju ponechajte na /config/database.sqlite, jej predvolenej hodnote: kdekoľvek inde by sa databáza vytvorila vnútri kontajnera a pri jeho opätovnom vytvorení by sa stratila. Zo vzoru si ponechajte len riadky, ktoré potrebujete.
Dokumentácia odporúča umiestniť pred Komgu reverznú proxy, ktorá získa platný certifikát, a navrhuje Caddy, ktorý si sám generuje certifikáty Let’s Encrypt. Proxy musí nastaviť tri hlavičky, aby Komga poznala verejnú adresu a protokol každej požiadavky:
X-Forwarded-For, nastavená alebo doplnená;X-Forwarded-Proto;X-Forwarded-Host.Na subdoméne, bez základnej URL v nastaveniach Komgy, nastaví Caddy tieto hlavičky sám:
komga.example.com {
reverse_proxy 127.0.0.1:25600
}
V podpriečinku najprv nastavte základnú URL Komgy na /komga, v „Server Settings“ alebo premennou SERVER_SERVLET_CONTEXTPATH, a potom:
example.com {
reverse_proxy /komga/* 127.0.0.1:25600
}
Príklad pre Nginx v dokumentácii odovzdáva aj spojenia WebSocket. Pridajte tento blok map do sekcie http súboru /etc/nginx/nginx.conf:
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
Tento blok webu používa nastavenia z príkladu v dokumentácii, na porte 80, aby Certbot mohol nastaviť HTTPS. Riadok X-Forwarded-Host je pridaný, pretože ho vyžaduje zoznam hlavičiek v dokumentácii:
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ý príklad v dokumentácii ukazuje konečnú verziu: port 80 presmerovaný na HTTPS a blok na porte 443 s cestami k certifikátu.
Knižnica je skupina kníh uložená pod koreňovým priečinkom. Komga vytvorí sériu pre každý podpriečinok, v ľubovoľnej hĺbke, a knihu pre každý súbor, zaradenú do série jeho nadradeného priečinka. Metadáta zo súborov EPUB a zo súborov ComicInfo.xml vnútri archívov majú prednosť pred názvami priečinkov a súborov.
~/komga/data pre každú knižnicu, cez SFTP alebo príkazom rsync./data/manga, a kliknite na „Add“.rsync -av manga/ user@komga.example.com:komga/data/manga/
/data/manga a /data/comics existujú vedľa seba; /data a /data/manga nemôžu.#recycle.Kniha, ktorej súbor zmizne, sa namiesto odstránenia presunie do koša s označením „Unavailable“: jej metadáta, postup čítania a zoznamy sa vrátia, ak sa súbor znova objaví na svojom mieste. Svoje súbory teda môžete premenovávať a presúvať bez toho, aby ste o čokoľvek prišli. Kôš sa vyprázdňuje ručne, alebo po každom skenovaní, ak túto voľbu zapnete, a tá potom položky odstraňuje okamžite.
Obrazovka „Import“, „Books“ zaradí do vašich sérií knihy, ktoré ležia v inom priečinku servera, napríklad /data/import. Pri každom súbore zvolíte cieľovú sériu, číslo a názov; už použité číslo ponúkne nahradenie existujúcej knihy novšou verziou, pričom obe sa zobrazia vedľa seba. Komga súbory presunie, alebo na ne vytvorí pevné odkazy, keď to súborový systém dovolí, a inak ich skopíruje.
Zmena koreňového priečinka knižnice na cestu, ktorá so starou nesúvisí, vymaže jej série, knihy a postup čítania. FAQ opisuje, ako ju presunúť: hashovanie súborov zapnuté, automatické vyprázdňovanie koša vypnuté a potom skenovanie pred presunom.
Webová čítačka sa otvorí v prehliadači, na adrese servera. Pre aplikáciu alebo čítačku e-kníh ponúka Komga troje dverí, všetky na prevádzku cez HTTPS.
Komga funguje s akoukoľvek aplikáciou OPDS, verzie 1 alebo 2. Zadajte aplikácii jednu z týchto adries a potom e-mailovú adresu a heslo svojho účtu Komga:
https://komga.example.com/opds/v2/catalog
https://komga.example.com/opds/v1.2/catalog
Katalóg verzie 1.2 pridáva vyhľadávanie podľa sérií, cez OpenSearch, a čítanie stranu po strane bez sťahovania, cez rozšírenie OPDS PSE. Dokumentácia vedie zoznam otestovaných aplikácií pre Android, iOS aj iné platformy, s tým, čo každá podporuje.
Vaša čítačka Kobo sa synchronizuje s Komgou namiesto oficiálnych serverov Kobo. Knihy EPUB zo všetkých knižníc prichádzajú s metadátami a obálkou, za behu prevedené na KEPUB nástrojom Kepubify, ktorý je súčasťou obrazu Docker. Postup čítania sa synchronizuje oboma smermi.
.kobo/Kobo/Kobo eReader.conf, so zobrazenými skrytými súbormi.[OneStoreServices] nahraďte riadok api_endpoint adresou svojho servera, za ktorou nasleduje váš kľúč.api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY
api_endpoint, 443 pre adresu HTTPS.KOReader číta Komgu cez OPDS a svoj postup čítania synchronizuje cez synchronizačný server Komgy:
https://komga.example.com/koreader.Všetko, čo Komga vie o vašich knihách, je v /config; samotné knihy zostávajú v /data. Toto obsahuje /config pri predvolenej konfigurácii:
| Položka | Čo obsahuje |
|---|---|
database.sqlite | Hlavná databáza: knižnice, série, knihy, metadáta, používatelia, postup čítania, kolekcie, zoznamy na čítanie a vygenerované náhľady |
tasks.sqlite | Čakajúce úlohy na pozadí |
sessions.sqlite | Prihlasovacie relácie, od verzie 1.30.0 predvolene ukladané v databáze |
lucene/ | Vyhľadávací index |
fonts/ | Písma |
logs/ | Záznamy, vrátane komga.log |
application.yml | Vaša konfigurácia, ak ste ju vytvorili |
Databázy SQLite sa kopírujú pri zastavenej službe Komga, aby bola kópia konzistentná. Z priečinka so súborom compose.yaml:
docker compose stop
tar -czf komga-config-$(date +%F).tar.gz config
docker compose start
Posielajte tento archív mimo servera tak často, ako pridávate a čítate knihy. Uchovávajte aj kópiu svojich kníh, vrátane obálok, ktoré máte vedľa súborov: je to najväčší objem, ale mení sa málo a rsync posiela len to, čo je nové. Uložené na disku servera sa tieto archívy dostanú aj do jeho nočných záloh.
Na obnovu Komgu zastavte, nahraďte priečinok config priečinkom z archívu, skontrolujte, že ho stále vlastní používateľ z compose.yaml, a znova ju spustite.
S Docker Compose dokumentácia uvádza tieto príkazy, spúšťané z priečinka so súborom compose.yaml. Priečinok /config, pripojený zo servera, zachová vaše nastavenia:
docker compose pull
docker compose up -d
docker image prune
/config.jar Komgu zastavte a potom ju spustite súborom jar novej verzie.Hostovanie na vlastnom serveri vyžaduje popri aplikácii starať sa aj o server. Na Managed VPS preberajú server naše tímy a vašu inštanciu proaktívne sledujú; Komga zostáva vaším softvérom, s vašimi nastaveniami a vašimi knihami.
| Téma | Naše tímy | Vy |
|---|---|---|
| Server | Aktualizácie systému a zabezpečenia, vrátane zásahov na serveri | Čas, ktorý vyhovuje vašej činnosti |
| Dohľad | Server sledovaný 24 hodín denne, 7 dní v týždni, so zásahom bez čakania na vaše zavolanie | Čítanie záznamov vašej inštancie |
| Komga | Proaktívne sledovanie: chyby, spomalenia, pamäť a miesto na disku, s odporúčanou opravou | Jej inštalácia, aktualizácie a nastavenia, ktoré zapracujete vy alebo váš AI asistent |
| Knižnice a čitatelia | Server, ktorý ich nesie, sledovaný a zálohovaný | Knižnice, účty, roly a kľúče API |
| Zálohy | Každú noc, šifrované a uchovávané mimo stroja; obnova je v cene | Kópie špecifické pre Komgu a žiadosť o obnovu, keď ju potrebujete |
| Migrácia | Váš súčasný server prenesený zdarma | Čas prepnutia |
Ak by ste uprednostnili, aby naše tímy zasiahli priamo v aplikácii, táto služba sa fakturuje hodinovo alebo paušálne, s cenovou ponukou oznámenou pred zásahom.
S Managed VPS od Simafri udržiavajú naše tímy server vašej inštancie Komga aktuálny, sledujú ho vo dne v noci a zasahujú bez čakania na vaše zavolanie; vašu inštanciu navyše proaktívne sledujú a odporúčajú vám užitočné opravy, ktoré zapracujete vy alebo váš AI asistent. Zálohy sa každú noc šifrujú a uchovávajú mimo stroja, ich obnova je v cene a migrácia vášho súčasného servera je zdarma.
Áno. Komga vychádza pod licenciou MIT: môžete ju vo firme používať, upravovať a ďalej šíriť bez licencie, ktorú by ste museli kupovať, pokiaľ zachováte jej upozornenie o autorských právach. Zostáva náklad na server, na ktorom beží.
Dokumentácia neurčuje žiadne minimum. Predvolene Java obmedzuje pamäť Komgy, zvyčajne približne na 1 GB. Ak záznamy ukazujú chyby OutOfMemoryException, zvýšte limit pomocou JAVA_TOOL_OPTIONS, napríklad -Xmx4g pre 4 GB.
Vytvorte compose.yaml s obrazom gotson/komga, portom 25600 publikovaným na 127.0.0.1, priečinkom config pripojeným na /config, priečinkom data pripojeným na /data a používateľom, ktorý oba vlastní, a spustite docker compose up -d. Potom pred port 25600 umiestnite reverznú proxy s HTTPS.
Pri prvom prístupe Komga požiada o e-mailovú adresu a heslo: tento prvý účet dostane všetky roly. Vytvorte ho cez tunel SSH skôr, než server otvoríte verejnosti, a ďalšie účty potom vytvárajte v Server Settings, Users.
Adresu svojho servera, za ktorou nasleduje /opds/v2/catalog pre OPDS 2, alebo /opds/v1.2/catalog pre OPDS 1.2, spolu s e-mailovou adresou a heslom svojho účtu Komga.
Prideľte účtu roly Kobo Sync a File Download, vygenerujte kľúč API v Account Settings a potom nahraďte riadok api_endpoint v súbore Kobo eReader.conf adresou https://your-server/kobo/your-key. Synchronizujú sa len knihy EPUB.
Zastavte Komgu, archivujte priečinok config, znova ju spustite a archív pošlite mimo servera. Uchovávajte aj kópiu svojich kníh. Kópiu si vytvorte aj tesne pred každou aktualizáciou.
Managed VPS pokrýva server: systém, zabezpečenie, dohľad a zálohy. Naše tímy vašu inštanciu aj proaktívne sledujú a odporúčajú vám užitočné opravy, ktoré zapracujete vy. Zásah v samotnej aplikácii sa fakturuje hodinovo alebo paušálne.
Simafri
Porozprávajme sa o vašom zámere
Povedzte nám v pár slovách, čo potrebujete: rýchlo sa vám ozveme.
Ďakujeme! Vaša žiadosť bola odoslaná. Čoskoro sa vám ozveme.
Máte radšej e-mail? Napíšte nám na support@simafri.com.