Hosting Komga na Managed VPS: Państwa komiksy i mangi na Państwa serwerze

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.

Simon Vasconcelos Lee Autor: Opublikowano 22 listopada 2026Czas czytania: 14 minut

Wszystkie poradniki

W skrócie

  1. Licencja MIT pozwala swobodnie używać, modyfikować i rozpowszechniać Komgę, w pracy czy gdziekolwiek indziej, pod warunkiem zachowania informacji o prawach autorskich.
  2. Miejsce na dysku dobiera się do rozmiaru Państwa kolekcji, przechowywanej w /data; baza danych, indeks i dzienniki znajdują się w /config, na dysku lokalnym.
  3. Proszę zainstalować ją przez Docker Compose: obraz gotson/komga, port 25600 opublikowany lokalnie za odwrotnym proxy z HTTPS i użytkownik, który jest właścicielem obu katalogów.
  4. Pierwsze utworzone konto zostaje kontem administratora: proszę utworzyć je przez tunel SSH, zanim serwer zostanie otwarty dla publiczności.
  5. Proszę zatrzymać Komgę, skopiować katalog /config poza serwer, zachować kopię swoich książek, a aktualizować poleceniem docker compose pull.

Co robi Komga

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.

Na co pozwala licencja MIT

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.

Pamięć, procesor i miejsce na dysku: dobór serwera

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.

Pamięć Javy

Procesor

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

Miejsce na Państwa książki

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:

Na Managed VPS wystarczy opisać nam swoją kolekcję, jej rozmiar, tempo wzrostu i liczbę czytelników, a polecimy odpowiedni rozmiar.

Instalacja przez Docker Compose

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:

Terminal
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ą:

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
Terminal
docker compose up -d
docker logs -f komga

Bez Dockera: plik jar

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:

Terminal
java -version
java -jar komga-1.30.1.jar

Pierwsze konto i użytkownicy

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.

Terminal, na Państwa komputerze
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:

RolaNa co pozwala
AdministratorZarządzanie bibliotekami, użytkownikami i kolekcjami, edycja metadanych, uruchamianie skanowania, analizy i odświeżania metadanych
Page StreamingCzytanie strona po stronie, na przykład w czytniku webowym
File DownloadPobieranie pliku książki
Kobo SyncSynchronizacja czytnika Kobo, razem z File Download
KOReader SyncSynchronizacja 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ę.

Resetowanie hasła z wiersza poleceń

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:

compose.yaml, w usłudze komga
    command: --newpassword=YourNewPassword --reset=admin@example.org
Terminal
docker compose up -d

Polecenie --list-users, użyte w ten sam sposób, wypisuje listę kont w dziennikach.

Konfiguracja: zmienne lub application.yml

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.

ZmiennaWłaściwośćWartość domyślnaDo czego służy
SERVER_PORTserver.port25600Port API i interfejsu webowego
SERVER_SERVLET_CONTEXTPATHserver.servlet.context-path/Bazowy adres URL, aby udostępniać Komgę z podkatalogu
SPRING_SESSION_TIMEOUTspring.session.timeout7 dniCzas trwania nieaktywnej sesji, na przykład 14d lub 24h
KOMGA_CORS_ALLOWEDORIGINSkomga.cors.allowed-originsBrakŹródła (origins) dopuszczone dla CORS
LOGGING_LEVEL_ORG_GOTSON_KOMGAlogging.level.org.gotson.komgaNieustawionaDEBUG 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:

compose.yaml, w sekcji environment
      - 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ą.

HTTPS i odwrotne proxy

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:

Z Caddy

Na subdomenie, bez bazowego adresu URL w ustawieniach Komgi, Caddy sam ustawia te nagłówki:

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

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

Z Nginx

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:

nginx.conf, w sekcji http
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:

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;
    }
}
Terminal
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.

Biblioteki, skanowanie i importy

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.

  1. Proszę umieścić pliki na serwerze, w jednym podkatalogu ~/komga/data na bibliotekę, przez SFTP lub poleceniem rsync.
  2. W interfejsie proszę kliknąć + obok „Libraries”.
  3. Proszę nazwać bibliotekę, wybrać jej katalog główny przyciskiem „Browse”, na przykład /data/manga, a następnie kliknąć „Add”.
Terminal, na Państwa komputerze
rsync -av manga/ user@komga.example.com:komga/data/manga/

Kosz

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.

Importowanie książek

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.

Czytanie wszędzie: OPDS, Kobo i KOReader

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.

OPDS

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:

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

Kobo Sync

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.

  1. Proszę nadać kontu role Kobo Sync i File Download.
  2. Proszę wygenerować klucz API na stronie swojego konta, „Account Settings”, i zapisać go: jest wyświetlany tylko raz. Proszę używać jednego klucza na czytnik.
  3. Proszę podłączyć Kobo do komputera i otworzyć plik .kobo/Kobo/Kobo eReader.conf, z włączonym wyświetlaniem plików ukrytych.
  4. W grupie [OneStoreServices] proszę zastąpić wiersz api_endpoint adresem swojego serwera, po którym następuje Państwa klucz.
Kobo eReader.conf
api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY

KOReader Sync

KOReader czyta Komgę przez OPDS i synchronizuje postęp czytania przez serwer synchronizacji Komgi:

  1. Proszę nadać kontu rolę KOReader Sync i włączyć obliczanie skrótów plików dla KOReader w opcjach biblioteki.
  2. Proszę wygenerować klucz API na stronie swojego konta.
  3. W KOReader, przy otwartej książce, proszę przejść do „Progress sync”, a następnie „Custom sync server”, i wpisać https://komga.example.com/koreader.
  4. W „Register / Login” proszę wpisać klucz API jako nazwę użytkownika, a jako hasło dowolną wartość, której Komga nie używa.
  5. W „Document matching method” proszę wybrać „Binary”.

Kopie zapasowe

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:

ElementCo przechowuje
database.sqliteGłówna baza danych: biblioteki, serie, książki, metadane, użytkownicy, postęp czytania, kolekcje, listy lektur i wygenerowane miniatury
tasks.sqliteOczekujące zadania w tle
sessions.sqliteSesje logowania, domyślnie przechowywane w bazie od wersji 1.30.0
lucene/Indeks wyszukiwania
fonts/Czcionki
logs/Dzienniki, w tym komga.log
application.ymlPań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:

Terminal, w ~/komga
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.

Aktualizacje

Przy Docker Compose dokumentacja podaje te polecenia, wydawane z katalogu z compose.yaml. Katalog /config, zamontowany z serwera, zachowuje Państwa ustawienia:

Terminal
docker compose pull
docker compose up -d
docker image prune

Kto za co odpowiada na Managed VPS

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.

TematNasze zespołyPaństwo
SerwerAktualizacje systemu i zabezpieczeń, w tym interwencje na serwerzeMoment dogodny dla Państwa działalności
NadzórSerwer pod opieką całą dobę, 7 dni w tygodniu, z interwencją bez czekania na Państwa telefonCzytanie dzienników Państwa instancji
KomgaProaktywna 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 czytelnicySerwer, który je utrzymuje, nadzorowany i objęty kopiami zapasowymiBiblioteki, konta, role i klucze API
Kopie zapasoweCo noc, szyfrowane i przechowywane poza maszyną; przywracanie w cenieKopie właściwe dla Komgi oraz zgłoszenie prośby o przywrócenie, gdy będzie potrzebne
MigracjaMigracja Państwa obecnego serwera, bezpłatnaMoment 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ą.

Komga na serwerze prowadzonym za Państwa

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.

Poznaj Managed VPS

Częste pytania

Czy Komga jest bezpłatna dla firmy?

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.

Ile pamięci potrzebuje Komga?

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.

Jak zainstalować Komgę przez Docker Compose?

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.

Jak utworzyć konto administratora Komgi?

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.

Jaki adres OPDS podać aplikacji do czytania?

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.

Jak zsynchronizować czytnik Kobo z Komgą?

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.

Jak wykonać kopię zapasową Komgi?

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

Czy Managed VPS obejmuje Komgę?

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.

Źródła i oficjalna dokumentacja

Skontaktuj się z nami