Hosting Komga na Managed VPS oznacza, że czytają Państwo swoje komiksy, mangi i e-booki z maszyny, która należy do Państwa, a nasze zespoły dbają o jej aktualność i nadzorują ją dniem i nocą. Komga to serwer multimediów, wolne oprogramowanie na licencji MIT. Ten poradnik podąża za jej oficjalną dokumentacją: pamięć i miejsce na dysku do zaplanowania, instalacja przez Docker Compose, pierwsze konto, konfiguracja, HTTPS, biblioteki, czytanie przez OPDS, Kobo i KOReader, kopie zapasowe i aktualizacje.
Autor: Simon Vasconcelos Lee
Opublikowano 22 listopada 2026Czas czytania: 14 minut
/data; baza danych, indeks i dzienniki znajdują się w /config, na dysku lokalnym.gotson/komga, port 25600 opublikowany lokalnie za odwrotnym proxy z HTTPS i użytkownik, który jest właścicielem obu katalogów./config poza serwer, zachować kopię swoich książek, a aktualizować poleceniem docker compose pull.Komga to serwer multimediów dla Państwa komiksów, mang, albumów bande dessinée, czasopism i e-booków. Wystarczy wskazać jej katalogi z plikami, a ona porządkuje je w biblioteki, serie i książki, po czym udostępnia je w przeglądarce lub w aplikacji do czytania. Działa wszędzie tam, gdzie działa Java lub Docker.
Komga jest udostępniana na licencji MIT, na nazwisko Gauthiera Roebroecka. Przyznaje ona bezpłatnie prawo do używania, kopiowania, modyfikowania, łączenia, publikowania, rozpowszechniania, sublicencjonowania i sprzedawania kopii oprogramowania. Mogą więc Państwo uruchomić ją dla siebie, swojej rodziny, stowarzyszenia lub firmy, bez zakupu licencji.
Jedynym warunkiem jest zachowanie informacji o prawach autorskich i tekstu licencji we wszystkich kopiach lub istotnych częściach oprogramowania. Tekst dostarcza oprogramowanie „w stanie, w jakim jest”, bez gwarancji.
Dokumentacja nie określa minimalnej konfiguracji. Podaje natomiast to, co liczy się przy doborze serwera: pamięć maszyny wirtualnej Javy, zadania obciążające procesor, a przede wszystkim miejsce zajmowane przez Państwa pliki.
OutOfMemoryException w dziennikach. Limit podnosi się wtedy zmienną JAVA_TOOL_OPTIONS, pokazaną dalej.Procesor pracuje głównie podczas skanowania i analizy bibliotek. Dla każdej biblioteki dokumentacja ostrzega, że obliczanie skrótów plików, skrótów stron i skrótów KOReader, podobnie jak analiza wymiarów stron, może przy dużej bibliotece zużywać dużo zasobów. Liczbę wątków przeznaczonych na zadania w tle ustawia się w „Server Settings”.
To największa pozycja i mierzą ją Państwo po swojej stronie: rozmiar kolekcji plus zapas na książki, które zamierzają Państwo dodać. Komga czyta pliki tam, gdzie się znajdują, i ich nie kopiuje. Kilka wskazówek z dokumentacji zmienia te obliczenia:
/data na książki i importy: dokumentacja prosi, by umieścić w nim biblioteki i katalog importu, tak aby importy tworzyły twarde dowiązania zamiast kopii. Poza tym samym systemem plików każdy import zajmuje tyle miejsca co kopia./config przechowuje główną bazę danych, z miniaturami wygenerowanymi dla każdej książki, bazę zadań, bazę sesji, indeks wyszukiwania i dzienniki, które domyślna konfiguracja przechowuje przez 7 dni i ogranicza do 1 GB. Rośnie wraz z rozmiarem bibliotek./config: bazy SQLite nigdy nie mogą znajdować się w udziale sieciowym, takim jak CIFS lub NFS. Komga sprawdza to przy starcie i zatrzymuje się, jeśli tak nie jest.Na Managed VPS wystarczy opisać nam swoją kolekcję, jej rozmiar, tempo wzrostu i liczbę czytelników, a polecimy odpowiedni rozmiar.
Dokumentacja publikuje obraz gotson/komga na Docker Hub i na ghcr.io, dla procesorów amd64, arm64 i arm. Na serwerze z zainstalowanym Dockerem proszę utworzyć katalog dla Komgi z dwoma podkatalogami i zanotować swój identyfikator użytkownika:
mkdir -p ~/komga/config ~/komga/data/import
cd ~/komga
id
Proszę umieścić w nim ten compose.yaml, zaczerpnięty z przykładu w dokumentacji. Proszę zastąpić 1000:1000 wartościami uid i gid wyświetlonymi przez id, a TZ swoją strefą czasową:
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 główna zmiana względem przykładu z dokumentacji, który publikuje go na wszystkich adresach. Dokumentacja zdecydowanie zaleca HTTPS, gdy tylko Komga zostaje otwarta poza siecią lokalną, ponieważ używa podstawowego uwierzytelniania HTTP (basic). Interfejs jest wtedy osiągalny wyłącznie przez odwrotne proxy.user. Dokumentacja prosi, by właścicielem zamontowanych katalogów był ten sam użytkownik: problemy z uprawnieniami wtedy znikają./config przechowuje bazę danych i konfigurację Komgi, na dysku lokalnym./data przechowuje Państwa książki i katalog importu. Każda biblioteka będzie miała w nim własny podkatalog.1.x podąża za najnowszą opublikowaną wersją 1; 1.30.1 przypina wersję. Dokumentacja opisuje latest jako najnowszy commit.version z przykładu w dokumentacji został pominięty: Docker Compose uznaje go teraz za przestarzały i ignoruje.Druga droga z dokumentacji dla serwera z Linuksem to plik jar każdego wydania, publikowany na GitHubie. Wymaga Javy 17 lub nowszej i przechowuje swoją konfigurację w ~/.komga:
java -version
java -jar komga-1.30.1.jar
Przy pierwszym wejściu Komga prosi o utworzenie konta: adresu e-mail i hasła. To pierwsze konto otrzymuje wszystkie role, w tym administrację, i „przejmuje” serwer. Dopóki ono nie istnieje, ten formularz odpowiada każdemu, kto dotrze do strony: proszę utworzyć je przez tunel SSH, zanim serwer zostanie otwarty dla publiczności. Port 25600 serwera pojawia się wtedy na Państwa komputerze, pod adresem http://localhost:25600. Proszę dodać -p i port SSH podany w Państwa strefie klienta.
ssh -L 25600:127.0.0.1:25600 user@komga.example.com
Kolejne konta tworzy administrator, w „Server Settings”, „Users”, przyciskiem +. Każde konto otrzymuje potrzebne mu role:
| Rola | Na co pozwala |
|---|---|
| Administrator | Zarządzanie bibliotekami, użytkownikami i kolekcjami, edycja metadanych, uruchamianie skanowania, analizy i odświeżania metadanych |
| Page Streaming | Czytanie strona po stronie, na przykład w czytniku webowym |
| File Download | Pobieranie pliku książki |
| Kobo Sync | Synchronizacja czytnika Kobo, razem z File Download |
| KOReader Sync | Synchronizacja postępu czytania z KOReader |
Usunięcie użytkownika bezpowrotnie kasuje cały jego postęp czytania: kopia /config wykonana tuż przed tym pozwala zachować kontrolę.
Dokumentacja dodaje polecenie do compose.yaml, w usłudze komga; Komga wprowadza zmianę, a potem startuje jak zwykle. Proszę ponownie uruchomić usługę, następnie usunąć ten wiersz i uruchomić ją ponownie jeszcze raz:
command: --newpassword=YourNewPassword --reset=admin@example.org
docker compose up -d
Polecenie --list-users, użyte w ten sam sposób, wypisuje listę kont w dziennikach.
Komga ma wartości domyślne dla każdego ustawienia: konfiguracja jedynie zmienia jej zachowanie. Odbywa się przez zmienne środowiskowe, najprostszą drogę przy Docker Compose, albo przez plik application.yml utworzony w katalogu /config, skąd wczytuje go obraz Docker. Aby zamienić nazwę właściwości na nazwę zmiennej, proszę zastąpić kropki podkreślnikami, usunąć myślniki i zamienić litery na wielkie.
| Zmienna | Właściwość | Wartość domyślna | Do czego służy |
|---|---|---|---|
SERVER_PORT | server.port | 25600 | Port API i interfejsu webowego |
SERVER_SERVLET_CONTEXTPATH | server.servlet.context-path | / | Bazowy adres URL, aby udostępniać Komgę z podkatalogu |
SPRING_SESSION_TIMEOUT | spring.session.timeout | 7 dni | Czas trwania nieaktywnej sesji, na przykład 14d lub 24h |
KOMGA_CORS_ALLOWEDORIGINS | komga.cors.allowed-origins | Brak | Źródła (origins) dopuszczone dla CORS |
LOGGING_LEVEL_ORG_GOTSON_KOMGA | logging.level.org.gotson.komga | Nieustawiona | DEBUG dla szczegółowych dzienników |
Port i bazowy adres URL można też ustawić w „Server Settings”, a to ustawienie ma wtedy pierwszeństwo przed konfiguracją. Dla pamięci Javy proszę dodać zmienną JAVA_TOOL_OPTIONS do sekcji environment. Przykład z dokumentacji ustawia maksimum 4 GB:
- JAVA_TOOL_OPTIONS=-Xmx4g
Przykładowy application.yml z dokumentacji zaczyna się od ścieżki bazy danych. Przy Dockerze proszę pozostawić ją na /config/database.sqlite, jej wartości domyślnej: w każdym innym miejscu baza zostałaby utworzona wewnątrz kontenera i utracona przy jego ponownym utworzeniu. Proszę zachować tylko te wiersze przykładu, których Państwo potrzebują.
Dokumentacja zaleca umieszczenie przed Komgą odwrotnego proxy, które uzyskuje ważny certyfikat, i proponuje Caddy, który sam generuje certyfikaty Let’s Encrypt. Proxy musi ustawiać trzy nagłówki, aby Komga znała publiczny adres i protokół każdego żądania:
X-Forwarded-For, ustawiony lub uzupełniony;X-Forwarded-Proto;X-Forwarded-Host.Na subdomenie, bez bazowego adresu URL w ustawieniach Komgi, Caddy sam ustawia te nagłówki:
komga.example.com {
reverse_proxy 127.0.0.1:25600
}
W podkatalogu proszę najpierw ustawić bazowy adres URL Komgi na /komga, w „Server Settings” lub zmienną SERVER_SERVLET_CONTEXTPATH, a następnie:
example.com {
reverse_proxy /komga/* 127.0.0.1:25600
}
Przykład dla Nginx z dokumentacji przekazuje także połączenia WebSocket. Proszę dodać ten blok map do sekcji http pliku /etc/nginx/nginx.conf:
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
Ten blok strony używa ustawień z przykładu w dokumentacji, na porcie 80, aby Certbot mógł zainstalować HTTPS. Wiersz X-Forwarded-Host został dodany, ponieważ wymaga go lista nagłówków w dokumentacji:
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
Pełny przykład w dokumentacji pokazuje wersję końcową: port 80 przekierowany na HTTPS i blok na porcie 443 ze ścieżkami certyfikatu.
Biblioteka to grupa książek przechowywana w katalogu głównym. Komga tworzy serię dla każdego podkatalogu, na dowolnej głębokości, i książkę dla każdego pliku, umieszczaną w serii jego katalogu nadrzędnego. Metadane z plików EPUB i z plików ComicInfo.xml wewnątrz archiwów mają pierwszeństwo przed nazwami katalogów i plików.
~/komga/data na bibliotekę, przez SFTP lub poleceniem rsync./data/manga, a następnie kliknąć „Add”.rsync -av manga/ user@komga.example.com:komga/data/manga/
/data/manga i /data/comics istnieją obok siebie; /data i /data/manga nie mogą.#recycle.Książka, której plik znika, trafia do kosza z oznaczeniem „Unavailable”, zamiast zostać usunięta: jej metadane, postęp czytania i listy wracają, jeśli plik pojawi się z powrotem na swoim miejscu. Mogą więc Państwo zmieniać nazwy plików i przenosić je bez żadnej straty. Kosz opróżnia się ręcznie albo po każdym skanowaniu, jeśli włączą Państwo tę opcję, która wtedy od razu usuwa elementy.
Ekran „Import”, „Books” umieszcza w Państwa seriach książki znajdujące się w innym katalogu serwera, na przykład /data/import. Dla każdego pliku wybierają Państwo serię docelową, numer i nazwę; numer, który jest już zajęty, pozwala zastąpić istniejącą książkę nowszą wersją, z obiema pokazanymi obok siebie. Komga przenosi pliki albo tworzy do nich twarde dowiązania, gdy system plików na to pozwala, a w przeciwnym razie je kopiuje.
Zmiana katalogu głównego biblioteki na ścieżkę niezwiązaną z poprzednią kasuje jej serie, książki i postęp czytania. FAQ opisuje, jak ją przenieść: włączone obliczanie skrótów plików, wyłączone automatyczne opróżnianie kosza, a następnie skanowanie przed przeniesieniem.
Czytnik webowy otwiera się w przeglądarce, pod adresem serwera. Dla aplikacji lub czytnika e-booków Komga oferuje trzy drogi dostępu, wszystkie do udostępniania przez HTTPS.
Komga współpracuje z każdą aplikacją OPDS, w wersji 1 lub 2. Proszę podać aplikacji jeden z tych adresów, a następnie adres e-mail i hasło swojego konta Komga:
https://komga.example.com/opds/v2/catalog
https://komga.example.com/opds/v1.2/catalog
Katalog w wersji 1.2 dodaje wyszukiwanie według serii, przez OpenSearch, oraz czytanie strona po stronie bez pobierania, przez rozszerzenie OPDS PSE. Dokumentacja prowadzi listę przetestowanych aplikacji, na Androida, iOS i inne platformy, wraz z tym, co każda z nich obsługuje.
Państwa czytnik Kobo synchronizuje się z Komgą zamiast z oficjalnymi serwerami Kobo. Książki EPUB ze wszystkich bibliotek docierają z metadanymi i okładką, konwertowane w locie do KEPUB przez Kepubify, dołączony do obrazu Docker. Postęp czytania synchronizuje się w obie strony.
.kobo/Kobo/Kobo eReader.conf, z włączonym wyświetlaniem plików ukrytych.[OneStoreServices] proszę zastąpić wiersz api_endpoint adresem swojego serwera, po którym następuje Państwa klucz.api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY
api_endpoint, 443 dla adresu HTTPS.KOReader czyta Komgę przez OPDS i synchronizuje postęp czytania przez serwer synchronizacji Komgi:
https://komga.example.com/koreader.Wszystko, co Komga wie o Państwa książkach, znajduje się w /config; same książki pozostają w /data. Oto, co zawiera /config przy domyślnej konfiguracji:
| Element | Co przechowuje |
|---|---|
database.sqlite | Główna baza danych: biblioteki, serie, książki, metadane, użytkownicy, postęp czytania, kolekcje, listy lektur i wygenerowane miniatury |
tasks.sqlite | Oczekujące zadania w tle |
sessions.sqlite | Sesje logowania, domyślnie przechowywane w bazie od wersji 1.30.0 |
lucene/ | Indeks wyszukiwania |
fonts/ | Czcionki |
logs/ | Dzienniki, w tym komga.log |
application.yml | Państwa konfiguracja, jeśli ją Państwo utworzyli |
Bazy SQLite kopiuje się przy zatrzymanej usłudze Komga, aby kopia była spójna. Z katalogu z compose.yaml:
docker compose stop
tar -czf komga-config-$(date +%F).tar.gz config
docker compose start
Proszę wysyłać to archiwum poza serwer tak często, jak dodają Państwo i czytają książki. Proszę też zachować kopię swoich książek, wraz z okładkami przechowywanymi obok plików: to największa objętość, ale zmienia się niewiele, a rsync wysyła tylko to, co nowe. Umieszczone na dysku serwera, archiwa te trafiają także do jego nocnych kopii zapasowych.
Aby przywrócić dane, proszę zatrzymać Komgę, zastąpić katalog config katalogiem z archiwum, sprawdzić, czy jego właścicielem nadal jest użytkownik z compose.yaml, a następnie uruchomić ją ponownie.
Przy Docker Compose dokumentacja podaje te polecenia, wydawane z katalogu z compose.yaml. Katalog /config, zamontowany z serwera, zachowuje Państwa ustawienia:
docker compose pull
docker compose up -d
docker image prune
/config tuż przed każdą aktualizacją.jar proszę zatrzymać Komgę, a następnie uruchomić ją plikiem jar nowej wersji.Samodzielny hosting wymaga prowadzenia serwera, oprócz samej aplikacji. Na Managed VPS nasze zespoły przejmują serwer i proaktywnie czuwają nad Państwa instancją; Komga pozostaje Państwa oprogramowaniem, z jej ustawieniami i Państwa książkami.
| Temat | Nasze zespoły | Państwo |
|---|---|---|
| Serwer | Aktualizacje systemu i zabezpieczeń, w tym interwencje na serwerze | Moment dogodny dla Państwa działalności |
| Nadzór | Serwer pod opieką całą dobę, 7 dni w tygodniu, z interwencją bez czekania na Państwa telefon | Czytanie dzienników Państwa instancji |
| Komga | Proaktywna opieka: wychwytujemy błędy, spowolnienia, zużycie pamięci i brak miejsca na dysku oraz polecamy poprawkę | Instalacja, aktualizacje i ustawienia, które wdrażają Państwo sami albo Państwa asystent AI |
| Biblioteki i czytelnicy | Serwer, który je utrzymuje, nadzorowany i objęty kopiami zapasowymi | Biblioteki, konta, role i klucze API |
| Kopie zapasowe | Co noc, szyfrowane i przechowywane poza maszyną; przywracanie w cenie | Kopie właściwe dla Komgi oraz zgłoszenie prośby o przywrócenie, gdy będzie potrzebne |
| Migracja | Migracja Państwa obecnego serwera, bezpłatna | Moment przełączenia |
Jeśli wolą Państwo, aby nasze zespoły interweniowały w samej aplikacji, usługa ta jest rozliczana godzinowo lub ryczałtowo, z wyceną przekazaną przed interwencją.
Z Managed VPS od Simafri nasze zespoły utrzymują serwer Państwa instancji Komga w aktualności, nadzorują go dniem i nocą i interweniują bez czekania na Państwa telefon; proaktywnie czuwają także nad Państwa instancją i polecają przydatne poprawki, które wdrażają Państwo sami albo Państwa asystent AI. Kopie zapasowe są szyfrowane co noc i przechowywane poza maszyną, ich przywracanie jest w cenie, a migracja obecnego serwera jest bezpłatna.
Tak. Komga jest udostępniana na licencji MIT: mogą Państwo używać jej, modyfikować ją i rozpowszechniać w firmie bez zakupu licencji, pod warunkiem zachowania informacji o prawach autorskich. Pozostaje koszt serwera, na którym działa.
Dokumentacja nie określa minimum. Domyślnie Java ogranicza pamięć Komgi, zwykle do około 1 GB. Jeśli dzienniki pokazują błędy OutOfMemoryException, proszę podnieść limit zmienną JAVA_TOOL_OPTIONS, na przykład -Xmx4g dla 4 GB.
Proszę utworzyć compose.yaml z obrazem gotson/komga, portem 25600 opublikowanym na 127.0.0.1, katalogiem config zamontowanym w /config, katalogiem data zamontowanym w /data i użytkownikiem, który jest właścicielem obu, a następnie uruchomić docker compose up -d. Potem proszę postawić przed portem 25600 odwrotne proxy z HTTPS.
Przy pierwszym wejściu Komga prosi o adres e-mail i hasło: to pierwsze konto otrzymuje wszystkie role. Proszę utworzyć je przez tunel SSH, zanim serwer zostanie otwarty dla publiczności, a następnie tworzyć pozostałe konta w Server Settings, Users.
Adres Państwa serwera, a po nim /opds/v2/catalog dla OPDS 2 albo /opds/v1.2/catalog dla OPDS 1.2, wraz z adresem e-mail i hasłem konta Komga.
Proszę nadać kontu role Kobo Sync i File Download, wygenerować klucz API w Account Settings, a następnie zastąpić wiersz api_endpoint w pliku Kobo eReader.conf adresem https://twoj-serwer/kobo/twoj-klucz. Synchronizowane są wyłącznie książki EPUB.
Proszę zatrzymać Komgę, zarchiwizować katalog config, uruchomić ją ponownie i wysłać archiwum poza serwer. Proszę też zachować kopię swoich książek. Kopię proszę wykonać również tuż przed każdą aktualizacją.
Managed VPS obejmuje serwer: system, bezpieczeństwo, nadzór i kopie zapasowe. Nasze zespoły proaktywnie czuwają też nad Państwa instancją i polecają przydatne poprawki, które wdrażają Państwo sami. Interwencja w aplikacji jest rozliczana godzinowo lub ryczałtowo.
Simafri
Porozmawiajmy o Państwa projekcie
Proszę powiedzieć nam w kilku słowach, czego Państwo potrzebują: odpowiemy szybko.
Dziękujemy! Państwa zapytanie zostało wysłane. Wkrótce się odezwiemy.
Wolą Państwo e-mail? Proszę napisać do nas na support@simafri.com.