Hostati Komga na Managed VPS-u znači čitati svoje stripove, mange i e-knjige sa stroja koji je vaš, a koji naši timovi održavaju ažurnim i nadziru danju i noću. Komga je medijski poslužitelj, slobodan softver pod licencom MIT. Ovaj vodič prati njezinu službenu dokumentaciju: memoriju i pohranu koje treba predvidjeti, instalaciju s Docker Composeom, prvi račun, konfiguraciju, HTTPS, knjižnice, čitanje putem OPDS-a, Koba i KOReadera, sigurnosne kopije i ažuriranja.
Autor: Simon Vasconcelos Lee
Objavljeno 22. studenoga 2026.Vrijeme čitanja: 14 minuta
/data; baza podataka, indeks i zapisnici nalaze se u /config, na lokalnom disku.gotson/komga, port 25600 objavljen lokalno iza obrnutog proxyja s HTTPS-om i korisnik koji je vlasnik obiju mapa./config izvan poslužitelja, čuvajte kopiju svojih knjiga, a ažurirajte s docker compose pull.Komga je medijski poslužitelj za vaše stripove, mange, francusko-belgijske stripove, časopise i e-knjige. Usmjerite je na mape u kojima su vaše datoteke, a ona ih organizira u knjižnice, serijale i knjige te ih zatim poslužuje pregledniku ili aplikaciji za čitanje. Radi svugdje gdje rade Java ili Docker.
Komga je objavljena pod licencom MIT, na ime Gauthiera Roebroecka. Ona besplatno daje pravo na upotrebu, kopiranje, izmjenu, spajanje, objavljivanje, distribuciju, podlicenciranje i prodaju primjeraka softvera. Stoga je možete pokretati za sebe, svoju obitelj, svoju udrugu ili svoju tvrtku, bez kupnje licence.
Jedini je uvjet zadržati napomenu o autorskim pravima i tekst licence u svim primjercima ili bitnim dijelovima softvera. Tekst softver daje „kakav jest”, bez jamstva.
Dokumentacija ne propisuje minimalnu konfiguraciju. Ono što navodi jest ono što je važno pri dimenzioniranju poslužitelja: memorija virtualnog stroja Java, zadaci koji opterećuju procesor i prije svega prostor koji zauzimaju vaše datoteke.
OutOfMemoryException u zapisnicima. Ograničenje se tada podiže varijablom JAVA_TOOL_OPTIONS, prikazanom u nastavku.Procesor radi uglavnom tijekom skeniranja i analize knjižnica. Za svaku knjižnicu dokumentacija upozorava da izračun hasheva datoteka, hasheva stranica i hasheva za KOReader, kao i analiza dimenzija stranica, može na velikoj knjižnici trošiti mnogo resursa. Broj niti namijenjenih zadacima u pozadini postavlja se u „Server Settings”.
To je najveća stavka i mjerite je sami: veličina vaše zbirke, uz prostor za knjige koje planirate dodati. Komga čita vaše datoteke ondje gdje jesu i ne kopira ih. Nekoliko točaka iz dokumentacije mijenja izračun:
/data za knjige i uvoze: dokumentacija traži da u nju smjestite svoje knjižnice i mapu za uvoz, kako bi uvozi stvarali tvrde poveznice umjesto kopija. Izvan istog datotečnog sustava svaki uvoz zauzima prostor kopije./config sadrži glavnu bazu podataka, sa sličicama generiranima za svaku knjigu, bazu zadataka, bazu sesija, indeks pretraživanja i zapisnike, koje zadana konfiguracija čuva 7 dana i ograničava na 1 GB. Raste s veličinom vaših knjižnica./config: baze SQLite nikada ne smiju biti na mrežnom dijeljenju poput CIFS-a ili NFS-a. Komga to provjerava pri pokretanju i zaustavlja se ako nije tako.Na Managed VPS-u opišite nam svoju zbirku, njezinu veličinu, brzinu rasta i broj čitatelja, a mi ćemo vam preporučiti pravu veličinu.
Dokumentacija objavljuje sliku gotson/komga na Docker Hubu i na ghcr.io, za procesore amd64, arm64 i arm. Na poslužitelju s instaliranim Dockerom izradite mapu za Komgu s njezine dvije podmape i zabilježite svoj korisnički ID:
mkdir -p ~/komga/config ~/komga/data/import
cd ~/komga
id
U nju stavite ovaj compose.yaml, preuzet iz primjera u dokumentaciji. Zamijenite 1000:1000 vrijednostima uid i gid koje prikazuje id, a TZ svojom vremenskom zonom:
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 glavno odstupanje od primjera u dokumentaciji, koji ga objavljuje na svim adresama. Dokumentacija snažno savjetuje HTTPS čim se Komga otvori izvan vaše lokalne mreže, jer koristi osnovnu HTTP autentifikaciju (basic). Sučelju se tada pristupa samo kroz obrnuti proxy.user. Dokumentacija traži da montirane mape budu u vlasništvu tog istog korisnika: problemi s dozvolama tada nestaju./config sadrži bazu podataka i konfiguraciju Komge, na lokalnom disku./data sadrži vaše knjige i vašu mapu za uvoz. Svaka knjižnica u njoj će imati svoju podmapu.1.x prati najnoviju objavljenu inačicu 1; 1.30.1 fiksira inačicu. Dokumentacija opisuje latest kao najnoviji commit.version iz primjera u dokumentaciji izostavljen je: Docker Compose ga sada smatra zastarjelim i zanemaruje ga.Drugi put iz dokumentacije za Linux poslužitelj jest datoteka jar svakog izdanja, objavljena na GitHubu. Zahtijeva Javu 17 ili noviju i svoju konfiguraciju čuva u ~/.komga:
java -version
java -jar komga-1.30.1.jar
Pri prvom pristupu Komga traži da izradite račun: adresu e-pošte i lozinku. Taj prvi račun dobiva sve uloge, uključujući administraciju, i „preuzima” poslužitelj. Dok ne postoji, ovaj obrazac odgovara svakome tko dođe do stranice: izradite ga kroz SSH tunel prije nego što poslužitelj otvorite javnosti. Port 25600 poslužitelja tada se pojavljuje na vašem računalu, na http://localhost:25600. Dodajte -p i SSH port naveden u vašem korisničkom prostoru.
ssh -L 25600:127.0.0.1:25600 user@komga.example.com
Ostale račune izrađuje administrator, u „Server Settings”, „Users”, gumbom +. Svaki račun dobiva uloge koje su mu potrebne:
| Uloga | Što omogućuje |
|---|---|
| Administrator | Upravljanje knjižnicama, korisnicima i kolekcijama, uređivanje metapodataka, pokretanje skeniranja, analize i osvježavanja metapodataka |
| Page Streaming | Čitanje stranicu po stranicu, na primjer u web-čitaču |
| File Download | Preuzimanje datoteke knjige |
| Kobo Sync | Sinkronizacija e-čitača Kobo, zajedno s File Download |
| KOReader Sync | Sinkronizacija napretka u čitanju s KOReaderom |
Brisanje korisnika nepovratno briše sav njegov napredak u čitanju: kopija mape /config napravljena neposredno prije toga čuva vam kontrolu.
Dokumentacija dodaje naredbu u compose.yaml, pod uslugu komga; Komga primjenjuje promjenu, a zatim se pokreće kao i obično. Ponovno pokrenite uslugu, zatim uklonite redak i ponovno je pokrenite još jednom:
command: --newpassword=YourNewPassword --reset=admin@example.org
docker compose up -d
Naredba --list-users, korištena na isti način, ispisuje popis računa u zapisnike.
Komga ima zadane vrijednosti za svaku postavku: konfiguracija samo mijenja njezino ponašanje. Provodi se varijablama okruženja, što je s Docker Composeom najjednostavniji put, ili datotekom application.yml koju izradite u mapi /config, odakle je slika Docker učitava. Da biste naziv svojstva pretvorili u naziv varijable, zamijenite točke podvlakama, uklonite crtice i sve pretvorite u velika slova.
| Varijabla | Svojstvo | Zadano | Čemu služi |
|---|---|---|---|
SERVER_PORT | server.port | 25600 | Port za API i web-sučelje |
SERVER_SERVLET_CONTEXTPATH | server.servlet.context-path | / | Osnovni URL, za posluživanje Komge iz podmape |
SPRING_SESSION_TIMEOUT | spring.session.timeout | 7 dana | Koliko traje neaktivna sesija, na primjer 14d ili 24h |
KOMGA_CORS_ALLOWEDORIGINS | komga.cors.allowed-origins | Nema | Izvori (origins) dopušteni za CORS |
LOGGING_LEVEL_ORG_GOTSON_KOMGA | logging.level.org.gotson.komga | Nije postavljeno | DEBUG za detaljne zapisnike |
Port i osnovni URL mogu se postaviti i u „Server Settings”, a ta postavka tada ima prednost pred konfiguracijom. Za memoriju Jave dodajte varijablu JAVA_TOOL_OPTIONS u odjeljak environment. Primjer iz dokumentacije postavlja najviše 4 GB:
- JAVA_TOOL_OPTIONS=-Xmx4g
Ogledni application.yml u dokumentaciji počinje putanjom baze podataka. S Dockerom je ostavite na /config/database.sqlite, njezinoj zadanoj vrijednosti: bilo gdje drugdje baza bi se izradila unutar spremnika i izgubila pri njegovom ponovnom stvaranju. Iz oglednog primjera zadržite samo retke koji vam trebaju.
Dokumentacija preporučuje da ispred Komge postavite obrnuti proxy koji pribavlja valjani certifikat i predlaže Caddy, koji sam generira certifikate Let’s Encrypt. Proxy mora postaviti tri zaglavlja, kako bi Komga znala javnu adresu i protokol svakog zahtjeva:
X-Forwarded-For, postavljeno ili dopunjeno;X-Forwarded-Proto;X-Forwarded-Host.Na poddomeni, bez osnovnog URL-a u postavkama Komge, Caddy sam postavlja ta zaglavlja:
komga.example.com {
reverse_proxy 127.0.0.1:25600
}
U podmapi najprije postavite osnovni URL Komge na /komga, u „Server Settings” ili varijablom SERVER_SERVLET_CONTEXTPATH, a zatim:
example.com {
reverse_proxy /komga/* 127.0.0.1:25600
}
Primjer za Nginx u dokumentaciji prosljeđuje i WebSocket veze. Dodajte ovaj blok map u odjeljak http datoteke /etc/nginx/nginx.conf:
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
Ovaj blok stranice koristi postavke iz primjera u dokumentaciji, na portu 80, kako bi Certbot mogao postaviti HTTPS. Redak X-Forwarded-Host je dodan jer ga traži popis zaglavlja u dokumentaciji:
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
Potpuni primjer u dokumentaciji prikazuje konačnu inačicu: port 80 preusmjeren na HTTPS i blok na portu 443 s putanjama certifikata.
Knjižnica je skupina knjiga smještena pod korijensku mapu. Komga stvara serijal za svaku podmapu, na bilo kojoj dubini, i knjigu za svaku datoteku, smještenu u serijal njezine nadređene mape. Metapodaci iz datoteka EPUB i iz datoteka ComicInfo.xml unutar arhiva imaju prednost pred nazivima mapa i datoteka.
~/komga/data po knjižnici, putem SFTP-a ili s rsync./data/manga, a zatim kliknite „Add”.rsync -av manga/ user@komga.example.com:komga/data/manga/
/data/manga i /data/comics postoje jedna uz drugu; /data i /data/manga ne mogu.#recycle.Knjiga čija datoteka nestane premješta se u koš, s oznakom „Unavailable”, umjesto da bude izbrisana: njezini metapodaci, napredak u čitanju i popisi vraćaju se ako se datoteka ponovno pojavi na svom mjestu. Stoga svoje datoteke možete preimenovati i premještati bez ikakvog gubitka. Koš se prazni ručno ili nakon svakog skeniranja, ako uključite tu opciju, koja tada odmah uklanja stavke.
Zaslon „Import”, „Books” smješta u vaše serijale knjige koje se nalaze u drugoj mapi poslužitelja, na primjer /data/import. Za svaku datoteku odabirete odredišni serijal, broj i naziv; broj koji je već zauzet nudi zamjenu postojeće knjige novijom inačicom, pri čemu su obje prikazane jedna uz drugu. Komga premješta datoteke, ili za njih stvara tvrde poveznice kada datotečni sustav to dopušta, a inače ih kopira.
Promjena korijenske mape knjižnice u putanju nepovezanu sa starom briše njezine serijale, knjige i napredak u čitanju. FAQ opisuje kako je premjestiti: uključeno računanje hasheva datoteka, isključeno automatsko pražnjenje koša, a zatim skeniranje prije premještanja.
Web-čitač otvara se u pregledniku, na adresi poslužitelja. Za aplikaciju ili e-čitač Komga nudi troja vrata, sva za posluživanje putem HTTPS-a.
Komga radi sa svakom OPDS aplikacijom, inačice 1 ili 2. Aplikaciji unesite jednu od ovih adresa, a zatim adresu e-pošte i lozinku svog Komga računa:
https://komga.example.com/opds/v2/catalog
https://komga.example.com/opds/v1.2/catalog
Katalog inačice 1.2 dodaje pretraživanje po serijalima, putem OpenSearcha, i čitanje stranicu po stranicu bez preuzimanja, putem proširenja OPDS PSE. Dokumentacija vodi popis testiranih aplikacija, za Android, iOS i druge platforme, s onim što svaka podržava.
Vaš e-čitač Kobo sinkronizira se s Komgom umjesto sa službenim poslužiteljima Koba. Knjige EPUB iz svih knjižnica stižu sa svojim metapodacima i naslovnicom, u hodu pretvorene u KEPUB alatom Kepubify, koji je dio slike Docker. Napredak u čitanju sinkronizira se u oba smjera.
.kobo/Kobo/Kobo eReader.conf, s prikazanim skrivenim datotekama.[OneStoreServices] zamijenite redak api_endpoint adresom svog poslužitelja iza koje slijedi vaš ključ.api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY
api_endpoint, 443 za HTTPS adresu.KOReader čita Komgu putem OPDS-a i sinkronizira svoj napredak u čitanju putem Komgina poslužitelja za sinkronizaciju:
https://komga.example.com/koreader.Sve što Komga zna o vašim knjigama nalazi se u /config; same knjige ostaju u /data. Evo što sadrži /config uz zadanu konfiguraciju:
| Stavka | Što sadrži |
|---|---|
database.sqlite | Glavna baza podataka: knjižnice, serijali, knjige, metapodaci, korisnici, napredak u čitanju, kolekcije, popisi za čitanje i generirane sličice |
tasks.sqlite | Zadaci u pozadini koji čekaju |
sessions.sqlite | Sesije prijave, od inačice 1.30.0 prema zadanim postavkama pohranjene u bazi |
lucene/ | Indeks pretraživanja |
fonts/ | Fontovi |
logs/ | Zapisnici, uključujući komga.log |
application.yml | Vaša konfiguracija, ako ste je izradili |
Baze SQLite kopiraju se dok je Komga zaustavljena, radi dosljedne kopije. Iz mape s datotekom compose.yaml:
docker compose stop
tar -czf komga-config-$(date +%F).tar.gz config
docker compose start
Šaljite tu arhivu izvan poslužitelja onoliko često koliko dodajete i čitate knjige. Čuvajte i kopiju svojih knjiga, zajedno s naslovnicama koje držite uz datoteke: to je najveći obujam, ali se malo mijenja, a rsync šalje samo ono što je novo. Postavljene na disk poslužitelja, te arhive ulaze i u njegove noćne sigurnosne kopije.
Za vraćanje zaustavite Komgu, zamijenite mapu config onom iz arhive, provjerite je li i dalje u vlasništvu korisnika iz compose.yaml, a zatim je ponovno pokrenite.
S Docker Composeom dokumentacija navodi ove naredbe, iz mape s datotekom compose.yaml. Mapa /config, montirana s poslužitelja, čuva vaše postavke:
docker compose pull
docker compose up -d
docker image prune
/config neposredno prije svakog ažuriranja.jar zaustavite Komgu, a zatim je pokrenite datotekom jar nove inačice.Hostanje na vlastitom poslužitelju traži da uz aplikaciju održavate i poslužitelj. Na Managed VPS-u naši timovi preuzimaju poslužitelj i proaktivno prate vašu instancu; Komga ostaje vaš softver, sa svojim postavkama i vašim knjigama.
| Tema | Naši timovi | Vi |
|---|---|---|
| Poslužitelj | Ažuriranja sustava i sigurnosti, uključujući intervencije na poslužitelju | Trenutak koji odgovara vašem poslovanju |
| Nadzor | Poslužitelj pod nadzorom 24 sata dnevno, 7 dana u tjednu, s intervencijom bez čekanja vašeg poziva | Čitanje zapisnika vaše instance |
| Komga | Proaktivno praćenje: uočene pogreške, usporavanja, memorija i prostor na disku, preporučen ispravak | Njezina instalacija, ažuriranja i postavke, koje primjenjujete vi ili vaš AI asistent |
| Knjižnice i čitatelji | Poslužitelj koji ih nosi, nadziran i sigurnosno kopiran | Knjižnice, računi, uloge i API ključevi |
| Sigurnosne kopije | Svake noći, šifrirane i čuvane izvan stroja; vraćanje uključeno | Kopije specifične za Komgu i zahtjev za vraćanje, kada vam zatreba |
| Migracija | Vaš trenutačni poslužitelj migriran, besplatno | Trenutak prelaska |
Ako želite da naši timovi interveniraju u samoj aplikaciji, ta se usluga naplaćuje po satu ili paušalno, uz procjenu koja vam se priopćuje prije intervencije.
Uz Simafri Managed VPS naši timovi održavaju poslužitelj vaše instance Komge ažurnim, nadziru ga danju i noću i interveniraju bez čekanja vašeg poziva; uz to proaktivno prate vašu instancu i preporučuju vam korisne ispravke, koje primjenjujete vi ili vaš AI asistent. Sigurnosne kopije svake se noći šifriraju i čuvaju izvan stroja, njihovo vraćanje je uključeno, a migracija vašeg trenutačnog poslužitelja je besplatna.
Da. Komga je pod licencom MIT: možete je koristiti, mijenjati i dalje distribuirati u tvrtki bez kupnje licence, uz zadržavanje napomene o autorskim pravima. Ostaje trošak poslužitelja na kojem radi.
Dokumentacija ne propisuje minimum. Prema zadanim postavkama Java ograničava memoriju Komge, obično na oko 1 GB. Ako zapisnici pokazuju pogreške OutOfMemoryException, podignite ograničenje s JAVA_TOOL_OPTIONS, na primjer -Xmx4g za 4 GB.
Izradite compose.yaml sa slikom gotson/komga, portom 25600 objavljenim na 127.0.0.1, mapom config montiranom na /config, mapom data montiranom na /data i korisnikom koji je vlasnik obiju, a zatim pokrenite docker compose up -d. Nakon toga ispred porta 25600 postavite obrnuti proxy s HTTPS-om.
Pri prvom pristupu Komga traži adresu e-pošte i lozinku: taj prvi račun dobiva sve uloge. Izradite ga kroz SSH tunel prije nego što poslužitelj otvorite javnosti, a zatim ostale račune izradite u izborniku Server Settings, Users.
Adresu svog poslužitelja iza koje slijedi /opds/v2/catalog za OPDS 2 ili /opds/v1.2/catalog za OPDS 1.2, uz adresu e-pošte i lozinku svog Komga računa.
Dodijelite računu uloge Kobo Sync i File Download, generirajte API ključ u Account Settings, a zatim zamijenite redak api_endpoint u datoteci Kobo eReader.conf adresom https://vaš-poslužitelj/kobo/vaš-ključ. Sinkroniziraju se samo knjige EPUB.
Zaustavite Komgu, arhivirajte mapu config, ponovno je pokrenite i pošaljite arhivu izvan poslužitelja. Čuvajte i kopiju svojih knjiga. Napravite kopiju i neposredno prije svakog ažuriranja.
Managed VPS pokriva poslužitelj: sustav, sigurnost, nadzor i sigurnosne kopije. Naši timovi proaktivno prate i vašu instancu te vam preporučuju korisne ispravke, koje primjenjujete vi. Intervencija u aplikaciji naplaćuje se po satu ili paušalno.
Simafri
Porazgovarajmo o Vašem projektu
Recite nam u nekoliko riječi što trebate: javljamo Vam se brzo.
Hvala! Vaš upit je poslan. Javit ćemo vam se uskoro.
Više volite e-mail? Pišite nam na support@simafri.com.