Hostovanie Komga na Managed VPS: vaše komiksy a mangy na vašom serveri

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.

Simon Vasconcelos Lee Autor: Publikované 22. novembra 2026Čas čítania: 14 minút

Všetci sprievodcovia

To najdôležitejšie

  1. Licencia MIT umožňuje Komgu voľne používať, upravovať a ďalej šíriť, vo firme aj inde, pokiaľ zachováte jej upozornenie o autorských právach.
  2. Úložisko sa dimenzuje podľa vašej zbierky uloženej v /data; databáza, index a záznamy sú v /config, na lokálnom disku.
  3. Nainštalujte ju cez Docker Compose: obraz gotson/komga, port 25600 publikovaný lokálne za reverznou proxy s HTTPS a používateľ, ktorý vlastní oba priečinky.
  4. Prvý vytvorený účet sa stane správcom: vytvorte ho cez tunel SSH skôr, než server otvoríte verejnosti.
  5. Zastavte Komgu, skopírujte priečinok /config mimo servera, uchovajte kópiu svojich kníh a aktualizujte príkazom docker compose pull.

Čo robí Komga

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.

Čo licencia MIT umožňuje

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.

Pamäť, procesor a úložisko: dimenzovanie servera

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.

Pamäť Javy

Procesor

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“.

Úložisko pre vaše knihy

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:

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ť.

Inštalácia cez Docker Compose

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:

Terminál
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:

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 Dockera: súbor jar

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:

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

Prvý účet a používatelia

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.

Terminál, na vašom počítači
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
AdministratorSprá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 DownloadStiahnutie súboru knihy
Kobo SyncSynchronizácia čítačky Kobo, spolu s File Download
KOReader SyncSynchronizá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.

Obnovenie hesla z príkazového riadka

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:

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

Príkaz --list-users, použitý rovnakým spôsobom, vypíše zoznam účtov do záznamov.

Konfigurácia: premenné alebo application.yml

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á hodnotaNa čo slúži
SERVER_PORTserver.port25600Port pre API a webové rozhranie
SERVER_SERVLET_CONTEXTPATHserver.servlet.context-path/Základná URL, na prevádzku Komgy v podpriečinku
SPRING_SESSION_TIMEOUTspring.session.timeout7 dníAko dlho trvá neaktívna relácia, napríklad 14d alebo 24h
KOMGA_CORS_ALLOWEDORIGINSkomga.cors.allowed-originsŽiadnaPôvody (origins) povolené pre CORS
LOGGING_LEVEL_ORG_GOTSON_KOMGAlogging.level.org.gotson.komgaNenastavené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:

compose.yaml, v sekcii environment
      - 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.

HTTPS a reverzná proxy

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:

S Caddy

Na subdoméne, bez základnej URL v nastaveniach Komgy, nastaví Caddy tieto hlavičky sám:

Caddyfile
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:

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

S Nginx

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:

nginx.conf, v sekcii http
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:

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ý 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žnice, skenovanie a importy

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.

  1. Umiestnite súbory na server, do jedného podpriečinka ~/komga/data pre každú knižnicu, cez SFTP alebo príkazom rsync.
  2. V rozhraní kliknite na + vedľa „Libraries“.
  3. Pomenujte knižnicu, vyberte jej koreňový priečinok tlačidlom „Browse“, napríklad /data/manga, a kliknite na „Add“.
Terminál, na vašom počítači
rsync -av manga/ user@komga.example.com:komga/data/manga/

Kôš

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.

Import kníh

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.

Čítanie kdekoľvek: OPDS, Kobo a KOReader

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.

OPDS

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:

Adresy OPDS
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.

Kobo Sync

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.

  1. Prideľte účtu roly Kobo Sync a File Download.
  2. Vygenerujte kľúč API na stránke svojho účtu, „Account Settings“, a poznačte si ho: zobrazí sa len raz. Používajte jeden kľúč na čítačku.
  3. Pripojte Kobo k počítaču a otvorte súbor .kobo/Kobo/Kobo eReader.conf, so zobrazenými skrytými súbormi.
  4. V skupine [OneStoreServices] nahraďte riadok api_endpoint adresou svojho servera, za ktorou nasleduje váš kľúč.
Kobo eReader.conf
api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY

KOReader Sync

KOReader číta Komgu cez OPDS a svoj postup čítania synchronizuje cez synchronizačný server Komgy:

  1. Prideľte účtu rolu KOReader Sync a v možnostiach knižnice zapnite hashovanie súborov pre KOReader.
  2. Vygenerujte kľúč API na stránke svojho účtu.
  3. V KOReaderi s otvorenou knihou prejdite do „Progress sync“, potom „Custom sync server“, a zadajte https://komga.example.com/koreader.
  4. V „Register / Login“ zadajte kľúč API ako používateľské meno a ako heslo ľubovoľnú hodnotu, ktorú Komga nepoužíva.
  5. V „Document matching method“ zvoľte „Binary“.

Zálohy

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.sqliteHlavná 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.sqlitePrihlasovacie 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.ymlVaš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:

Terminál, v ~/komga
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.

Aktualizácie

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:

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

Kto čo robí na Managed VPS

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émaNaše tímyVy
ServerAktualizácie systému a zabezpečenia, vrátane zásahov na serveriČas, ktorý vyhovuje vašej činnosti
DohľadServer 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
KomgaProaktívne sledovanie: chyby, spomalenia, pamäť a miesto na disku, s odporúčanou opravouJej inštalácia, aktualizácie a nastavenia, ktoré zapracujete vy alebo váš AI asistent
Knižnice a čitateliaServer, ktorý ich nesie, sledovaný a zálohovanýKnižnice, účty, roly a kľúče API
ZálohyKaždú noc, šifrované a uchovávané mimo stroja; obnova je v ceneKópie špecifické pre Komgu a žiadosť o obnovu, keď ju potrebujete
MigráciaVáš 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.

Komga na serveri, o ktorý sa staráme za vás

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.

Objaviť Managed VPS

Časté otázky

Je Komga pre firmu zadarmo?

Á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ží.

Koľko pamäte Komga potrebuje?

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.

Ako nainštalovať Komgu cez Docker Compose?

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.

Ako vytvoriť účet správcu Komgy?

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.

Akú adresu OPDS zadať čitateľskej aplikácii?

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.

Ako synchronizovať čítačku Kobo s Komgou?

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.

Ako zálohovať Komgu?

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.

Pokrýva Managed VPS aj Komgu?

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.

Kontaktujte nás