Komga auf einem Managed VPS zu hosten heißt, Ihre Comics, Mangas und E-Books von einer Maschine aus zu lesen, die Ihnen gehört und die unsere Teams aktuell halten und Tag und Nacht beaufsichtigen. Komga ist ein Medienserver und freie Software unter der MIT-Lizenz. Dieser Leitfaden folgt der offiziellen Dokumentation: der einzuplanende Arbeitsspeicher und Speicherplatz, die Installation mit Docker Compose, das erste Konto, die Konfiguration, HTTPS, die Bibliotheken, das Lesen über OPDS, Kobo und KOReader, Backups und Updates.
Von Simon Vasconcelos Lee
Veröffentlicht am 22. November 2026Lesezeit: 14 Minuten
/data liegt; Datenbank, Index und Protokolle liegen in /config, auf einer lokalen Festplatte.gotson/komga, der Port 25600 lokal hinter einem Reverse Proxy mit HTTPS veröffentlicht und ein Benutzer, dem beide Ordner gehören./config außerhalb des Servers, bewahren Sie eine Kopie Ihrer Bücher auf und aktualisieren Sie mit docker compose pull.Komga ist ein Medienserver für Ihre Comics, Mangas, Bandes dessinées, Zeitschriften und E-Books. Sie zeigen ihm die Ordner mit Ihren Dateien, es ordnet sie in Bibliotheken, Serien und Bücher und stellt sie dann einem Browser oder einer Lese-App bereit. Es läuft überall, wo Java oder Docker läuft.
Komga wird unter der MIT-Lizenz veröffentlicht, im Namen von Gauthier Roebroeck. Sie gewährt kostenlos das Recht, Kopien der Software zu nutzen, zu kopieren, zu ändern, zusammenzuführen, zu veröffentlichen, zu verbreiten, unterzulizenzieren und zu verkaufen. Sie können es also für sich selbst, Ihre Familie, Ihren Verein oder Ihr Unternehmen betreiben, ohne eine Lizenz zu kaufen.
Die einzige Bedingung ist, den Urheberrechtshinweis und den Lizenztext in allen Kopien oder wesentlichen Teilen der Software beizubehalten. Der Text stellt die Software „wie besehen“ bereit, ohne Gewährleistung.
Die Dokumentation legt keine Mindestkonfiguration fest. Sie nennt dafür, was bei der Bemessung des Servers zählt: den Arbeitsspeicher der Java Virtual Machine, die Aufgaben, die den Prozessor beanspruchen, und vor allem den Platz, den Ihre Dateien belegen.
OutOfMemoryException in den Protokollen. Die Grenze wird dann mit der Variablen JAVA_TOOL_OPTIONS angehoben, wie weiter unten gezeigt.Der Prozessor arbeitet vor allem beim Scannen und Analysieren der Bibliotheken. Für jede Bibliothek weist die Dokumentation darauf hin, dass das Berechnen der Datei-Hashes, Seiten-Hashes und KOReader-Hashes, ebenso wie die Analyse der Seitenmaße, bei einer großen Bibliothek viele Ressourcen beanspruchen kann. Die Zahl der Threads für Hintergrundaufgaben wird unter „Server Settings“ eingestellt.
Das ist der größte Posten, und Sie messen ihn selbst: die Größe Ihrer Sammlung, plus Platz für die Bücher, die Sie hinzufügen möchten. Komga liest Ihre Dateien dort, wo sie liegen, und kopiert sie nicht. Einige Punkte der Dokumentation verändern die Rechnung:
/data für Bücher und Importe: Die Dokumentation bittet Sie, Ihre Bibliotheken und Ihren Importordner dort abzulegen, damit Importe Hardlinks statt Kopien anlegen. Außerhalb desselben Dateisystems belegt jeder Import den Platz einer Kopie./config enthält die Hauptdatenbank mit den für jedes Buch erzeugten Vorschaubildern, die Aufgabendatenbank, die Sitzungsdatenbank, den Suchindex und die Protokolle, die die Standardkonfiguration 7 Tage lang aufbewahrt und auf 1 GB begrenzt. Er wächst mit der Größe Ihrer Bibliotheken./config: Die SQLite-Datenbanken dürfen niemals auf einer Netzwerkfreigabe wie CIFS oder NFS liegen. Komga prüft das beim Start und hält an, wenn es nicht der Fall ist.Nennen Sie uns auf einem Managed VPS Ihre Sammlung, ihre Größe, wie schnell sie wächst und wie viele Leser Sie haben, und wir empfehlen Ihnen die passende Größe.
Die Dokumentation veröffentlicht das Image gotson/komga auf Docker Hub und auf ghcr.io, für Prozessoren amd64, arm64 und arm. Legen Sie auf einem Server mit Docker einen Ordner für Komga mit seinen zwei Unterordnern an und notieren Sie Ihre Benutzerkennung:
mkdir -p ~/komga/config ~/komga/data/import
cd ~/komga
id
Legen Sie dort diese compose.yaml ab, übernommen aus dem Beispiel der Dokumentation. Ersetzen Sie 1000:1000 durch die von id angezeigten Werte uid und gid, und TZ durch Ihre Zeitzone:
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 veröffentlicht: Das ist die wichtigste Abweichung vom Beispiel der Dokumentation, das ihn auf allen Adressen veröffentlicht. Die Dokumentation empfiehlt HTTPS ausdrücklich, sobald Komga außerhalb Ihres lokalen Netzes geöffnet wird, weil es die HTTP-Basic-Authentifizierung nutzt. Die Oberfläche ist dann nur über den Reverse Proxy erreichbar.user angegebenen Kennung. Die Dokumentation verlangt, dass die eingebundenen Ordner demselben Benutzer gehören: Damit verschwinden Berechtigungsprobleme./config enthält die Datenbank und die Konfiguration von Komga, auf einer lokalen Festplatte./data enthält Ihre Bücher und Ihren Importordner. Jede Bibliothek bekommt dort ihren eigenen Unterordner.1.x folgt der neuesten veröffentlichten Version 1; 1.30.1 legt eine Version fest. Die Dokumentation beschreibt latest als den neuesten Commit.version aus dem Beispiel der Dokumentation entfällt: Docker Compose betrachtet sie inzwischen als veraltet und ignoriert sie.Der andere Weg der Dokumentation für einen Linux-Server ist die jar-Datei jeder Version, auf GitHub veröffentlicht. Sie braucht Java 17 oder neuer und speichert ihre Konfiguration in ~/.komga:
java -version
java -jar komga-1.30.1.jar
Beim ersten Aufruf bittet Komga Sie, ein Konto anzulegen: eine E-Mail-Adresse und ein Passwort. Dieses erste Konto erhält alle Rollen, die Administration eingeschlossen, und „beansprucht“ den Server. Solange es nicht existiert, antwortet dieses Formular jedem, der die Seite erreicht: Legen Sie es an, bevor Sie den Server öffentlich zugänglich machen, über einen SSH-Tunnel. Der Port 25600 des Servers erscheint dann auf Ihrem Computer, unter http://localhost:25600. Ergänzen Sie -p und den SSH-Port, der in Ihrem Kundenbereich angezeigt wird.
ssh -L 25600:127.0.0.1:25600 user@komga.example.com
Weitere Konten legt der Administrator unter „Server Settings“, „Users“ mit der Schaltfläche + an. Jedes Konto erhält die Rollen, die es braucht:
| Rolle | Was sie erlaubt |
|---|---|
| Administrator | Bibliotheken, Benutzer und Sammlungen verwalten, Metadaten bearbeiten, Scans, Analysen und Aktualisierungen der Metadaten starten |
| Page Streaming | Seite für Seite lesen, zum Beispiel im Webreader |
| File Download | Die Datei eines Buchs herunterladen |
| Kobo Sync | Einen Kobo-E-Reader synchronisieren, zusammen mit File Download |
| KOReader Sync | Den Lesefortschritt mit KOReader synchronisieren |
Das Löschen eines Benutzers entfernt seinen gesamten Lesefortschritt, unwiderruflich: Eine kurz zuvor angelegte Kopie von /config lässt Ihnen die Wahl.
Die Dokumentation ergänzt die Anweisung in der compose.yaml, unter dem Dienst komga; Komga übernimmt die Änderung und startet dann wie gewohnt. Starten Sie den Dienst neu, entfernen Sie danach die Zeile und starten Sie ihn noch einmal neu:
command: --newpassword=YourNewPassword --reset=admin@example.org
docker compose up -d
Die Anweisung --list-users, auf dieselbe Weise verwendet, gibt die Liste der Konten in den Protokollen aus.
Komga hat für jede Einstellung einen Standardwert: Die Konfiguration ändert nur sein Verhalten. Sie erfolgt über Umgebungsvariablen, der einfachste Weg mit Docker Compose, oder über eine Datei application.yml, die Sie im Ordner /config anlegen, wo das Docker-Image sie lädt. Um aus dem Namen einer Eigenschaft den Namen einer Variablen zu machen, ersetzen Sie Punkte durch Unterstriche, entfernen die Bindestriche und schreiben alles groß.
| Variable | Eigenschaft | Standardwert | Wirkung |
|---|---|---|---|
SERVER_PORT | server.port | 25600 | Der Port der API und der Weboberfläche |
SERVER_SERVLET_CONTEXTPATH | server.servlet.context-path | / | Die Basis-URL, um Komga in einem Unterordner bereitzustellen |
SPRING_SESSION_TIMEOUT | spring.session.timeout | 7 Tage | Die Dauer einer inaktiven Sitzung, zum Beispiel 14d oder 24h |
KOMGA_CORS_ALLOWEDORIGINS | komga.cors.allowed-origins | Keiner | Die für CORS zugelassenen Ursprünge |
LOGGING_LEVEL_ORG_GOTSON_KOMGA | logging.level.org.gotson.komga | Nicht gesetzt | DEBUG für ausführliche Protokolle |
Port und Basis-URL lassen sich auch unter „Server Settings“ festlegen, und diese Einstellung hat dann Vorrang vor der Konfiguration. Für den Java-Speicher ergänzen Sie den Abschnitt environment um die Variable JAVA_TOOL_OPTIONS. Das Beispiel der Dokumentation setzt ein Maximum von 4 GB:
- JAVA_TOOL_OPTIONS=-Xmx4g
Die Beispieldatei application.yml der Dokumentation beginnt mit dem Pfad der Datenbank. Behalten Sie ihn mit Docker auf /config/database.sqlite, seinem Standardwert: An jedem anderen Ort würde die Datenbank im Container angelegt und bei dessen Neuerstellung verloren gehen. Übernehmen Sie aus dem Beispiel nur die Zeilen, die Sie brauchen.
Die Dokumentation empfiehlt, Komga einen Reverse Proxy voranzustellen, der ein gültiges Zertifikat bezieht, und schlägt Caddy vor, das seine Let’s-Encrypt-Zertifikate selbst erzeugt. Der Proxy muss drei Header setzen, damit Komga die öffentliche Adresse und das Protokoll jeder Anfrage kennt:
X-Forwarded-For, gesetzt oder ergänzt;X-Forwarded-Proto;X-Forwarded-Host.Auf einer Subdomain, ohne Basis-URL in Komga, setzt Caddy diese Header selbst:
komga.example.com {
reverse_proxy 127.0.0.1:25600
}
In einem Unterordner setzen Sie zuerst die Basis-URL von Komga auf /komga, unter „Server Settings“ oder mit SERVER_SERVLET_CONTEXTPATH, dann:
example.com {
reverse_proxy /komga/* 127.0.0.1:25600
}
Das Nginx-Beispiel der Dokumentation leitet auch WebSocket-Verbindungen weiter. Ergänzen Sie den Abschnitt http von /etc/nginx/nginx.conf um diesen Block map:
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
Dieser Site-Block übernimmt die Einstellungen aus dem Beispiel der Dokumentation, auf Port 80, damit Certbot HTTPS einrichten kann. Die Zeile X-Forwarded-Host ist ergänzt, da die Header-Liste der Dokumentation sie verlangt:
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
Das vollständige Beispiel der Dokumentation zeigt die endgültige Fassung: Port 80 auf HTTPS umgeleitet und der Block auf Port 443 mit den Pfaden seines Zertifikats.
Eine Bibliothek ist eine Gruppe von Büchern unter einem Stammordner. Komga legt für jeden Unterordner, in beliebiger Tiefe, eine Serie an und für jede Datei ein Buch, das in die Serie seines übergeordneten Ordners einsortiert wird. Die Metadaten der EPUB-Dateien und der ComicInfo.xml-Dateien in den Archiven haben Vorrang vor den Namen der Ordner und Dateien.
~/komga/data pro Bibliothek, per SFTP oder mit rsync./data/manga, und klicken Sie dann auf „Add“.rsync -av manga/ user@komga.example.com:komga/data/manga/
/data/manga und /data/comics stehen nebeneinander; /data und /data/manga gehen nicht.#recycle.Ein Buch, dessen Datei verschwindet, wandert in den Papierkorb, als „Unavailable“ markiert, statt gelöscht zu werden: Seine Metadaten, sein Lesefortschritt und seine Listen kehren zurück, wenn die Datei an ihrem Platz wieder auftaucht. So können Sie Ihre Dateien umbenennen und verschieben, ohne etwas zu verlieren. Der Papierkorb wird von Hand geleert, oder nach jedem Scan, wenn Sie diese Option aktivieren, die die Elemente dann sofort entfernt.
Der Bildschirm „Import“, „Books“ sortiert Bücher aus einem anderen Ordner des Servers, zum Beispiel /data/import, in Ihre Serien ein. Für jede Datei wählen Sie die Zielserie, die Nummer und den Namen; bei einer bereits vergebenen Nummer wird angeboten, das vorhandene Buch zu ersetzen, wobei beide nebeneinander angezeigt werden. Komga verschiebt die Dateien oder legt Hardlinks an, wenn das Dateisystem es erlaubt, und kopiert sie andernfalls.
Wird der Stammordner einer Bibliothek auf einen Pfad geändert, der mit dem alten nichts zu tun hat, werden ihre Serien, Bücher und Lesefortschritte gelöscht. Die FAQ beschreibt, wie man sie verschiebt: Datei-Hashes aktiviert, automatisches Leeren des Papierkorbs deaktiviert, dann ein Scan vor dem Verschieben.
Der Webreader öffnet sich im Browser, unter der Adresse des Servers. Für eine App oder einen E-Reader bietet Komga drei Zugänge, die alle über HTTPS bereitzustellen sind.
Komga funktioniert mit jeder OPDS-App, Version 1 oder 2. Geben Sie der App eine dieser Adressen und dann die E-Mail-Adresse und das Passwort Ihres Komga-Kontos an:
https://komga.example.com/opds/v2/catalog
https://komga.example.com/opds/v1.2/catalog
Der Katalog in Version 1.2 ergänzt die Suche nach Serien über OpenSearch und das seitenweise Lesen ohne Herunterladen über die Erweiterung OPDS PSE. Die Dokumentation führt eine Liste getesteter Apps, unter Android, iOS und anderswo, mit dem, was jede unterstützt.
Ihr Kobo-E-Reader synchronisiert sich mit Komga statt mit den offiziellen Kobo-Servern. Die EPUB-Bücher aller Bibliotheken kommen mit ihren Metadaten und ihrem Cover an, im laufenden Betrieb von Kepubify in KEPUB umgewandelt, das im Docker-Image enthalten ist. Der Lesefortschritt wird in beide Richtungen synchronisiert.
.kobo/Kobo/Kobo eReader.conf, mit eingeblendeten versteckten Dateien.[OneStoreServices] die Zeile api_endpoint durch die Adresse Ihres Servers, gefolgt von Ihrem Schlüssel.api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY
api_endpoint, 443 für eine HTTPS-Adresse.KOReader liest Komga über OPDS und synchronisiert seinen Lesefortschritt über den Synchronisierungsserver von Komga:
https://komga.example.com/koreader ein.Alles, was Komga über Ihre Bücher weiß, liegt in /config; Ihre Bücher selbst bleiben in /data. Das enthält /config mit der Standardkonfiguration:
| Element | Inhalt |
|---|---|
database.sqlite | Die Hauptdatenbank: Bibliotheken, Serien, Bücher, Metadaten, Benutzer, Lesefortschritte, Sammlungen, Leselisten und erzeugte Vorschaubilder |
tasks.sqlite | Ausstehende Hintergrundaufgaben |
sessions.sqlite | Die Anmeldesitzungen, seit Version 1.30.0 standardmäßig in der Datenbank gespeichert |
lucene/ | Der Suchindex |
fonts/ | Die Schriften |
logs/ | Die Protokolle, darunter komga.log |
application.yml | Ihre Konfiguration, falls Sie eine angelegt haben |
Die SQLite-Datenbanken werden bei angehaltenem Komga kopiert, für eine konsistente Kopie. Aus dem Ordner der compose.yaml:
docker compose stop
tar -czf komga-config-$(date +%F).tar.gz config
docker compose start
Senden Sie dieses Archiv außerhalb des Servers, so oft, wie Sie Bücher hinzufügen und lesen. Bewahren Sie auch eine Kopie Ihrer Bücher auf, mit den Covern, die Sie neben den Dateien ablegen: Das ist das größte Volumen, aber es ändert sich wenig, und rsync überträgt nur das Neue. Auf der Festplatte des Servers gelagert, sind diese Archive auch Teil seiner nächtlichen Backups.
Zum Wiederherstellen halten Sie Komga an, ersetzen den Ordner config durch den aus dem Archiv, prüfen, dass er weiterhin dem Benutzer aus der compose.yaml gehört, und starten es dann wieder.
Mit Docker Compose gibt die Dokumentation diese Befehle an, aus dem Ordner der compose.yaml. Der Ordner /config, vom Server eingebunden, bewahrt Ihre Einstellungen:
docker compose pull
docker compose up -d
docker image prune
/config an.jar-Datei halten Sie Komga an und starten es dann mit der jar-Datei der neuen Version.Beim Selbsthosting müssen Sie neben der Anwendung auch den Server betreuen. Auf einem Managed VPS übernehmen unsere Teams den Server und betreuen Ihre Instanz proaktiv; Komga bleibt Ihre Software, mit ihren Einstellungen und Ihren Büchern.
| Thema | Unsere Teams | Sie |
|---|---|---|
| Der Server | System- und Sicherheitsupdates, Eingriffe am Server inbegriffen | Der Zeitpunkt, der zu Ihrem Betrieb passt |
| Die Überwachung | Server rund um die Uhr im Blick, mit Eingriff, ohne auf Ihren Anruf zu warten | Das Lesen der Protokolle Ihrer Instanz |
| Komga | Proaktive Betreuung: Fehler, lange Antwortzeiten, Arbeitsspeicher und Speicherplatz erkannt, Korrektur empfohlen | Installation, Updates und Einstellungen, die Sie umsetzen, selbst oder mit Ihrem KI-Assistenten |
| Die Bibliotheken und die Leser | Der Server, der sie trägt, überwacht und gesichert | Die Bibliotheken, die Konten, die Rollen und die API-Schlüssel |
| Die Backups | Jede Nacht, verschlüsselt und außerhalb der Maschine aufbewahrt; Wiederherstellung inbegriffen | Die eigenen Kopien von Komga und die Wiederherstellungsanfrage, wenn Sie sie brauchen |
| Die Migration | Ihr aktueller Server wird kostenlos migriert | Der Zeitpunkt der Umstellung |
Wenn unsere Teams lieber in der Anwendung selbst eingreifen sollen, wird diese Leistung nach Stunden oder pauschal abgerechnet, mit einem Kostenvoranschlag vor dem Eingriff.
Mit einem Managed VPS von Simafri halten unsere Teams den Server Ihrer Komga-Instanz aktuell, überwachen ihn Tag und Nacht und greifen ein, ohne auf Ihren Anruf zu warten; sie betreuen auch Ihre Instanz proaktiv und empfehlen Ihnen die sinnvollen Korrekturen, die Sie umsetzen, selbst oder mit Ihrem KI-Assistenten. Die Backups werden jede Nacht verschlüsselt und außerhalb der Maschine aufbewahrt, ihre Wiederherstellung ist inbegriffen, und die Migration Ihres aktuellen Servers ist kostenlos.
Ja. Komga steht unter der MIT-Lizenz: Sie können es im Unternehmen nutzen, ändern und weitergeben, ohne eine Lizenz zu kaufen, sofern Sie seinen Urheberrechtshinweis beibehalten. Bleiben die Kosten für den Server, auf dem es läuft.
Die Dokumentation legt kein Minimum fest. Standardmäßig begrenzt Java den Arbeitsspeicher von Komga, meist auf etwa 1 GB. Zeigen die Protokolle Fehler OutOfMemoryException, heben Sie die Grenze mit JAVA_TOOL_OPTIONS an, zum Beispiel -Xmx4g für 4 GB.
Legen Sie eine compose.yaml mit dem Image gotson/komga an, mit Port 25600 auf 127.0.0.1 veröffentlicht, einem auf /config eingebundenen Ordner config, einem auf /data eingebundenen Ordner data und einem Benutzer, dem beide gehören, und starten Sie docker compose up -d. Stellen Sie dann einen Reverse Proxy mit HTTPS vor Port 25600.
Beim ersten Aufruf fragt Komga nach einer E-Mail-Adresse und einem Passwort: Dieses erste Konto erhält alle Rollen. Legen Sie es über einen SSH-Tunnel an, bevor Sie den Server öffentlich zugänglich machen, und legen Sie die weiteren Konten dann unter Server Settings, Users an.
Die Adresse Ihres Servers, gefolgt von /opds/v2/catalog für OPDS 2 oder von /opds/v1.2/catalog für OPDS 1.2, mit der E-Mail-Adresse und dem Passwort Ihres Komga-Kontos.
Geben Sie dem Konto die Rollen Kobo Sync und File Download, erzeugen Sie unter Account Settings einen API-Schlüssel und ersetzen Sie dann die Zeile api_endpoint der Datei Kobo eReader.conf durch https://your-server/kobo/your-key. Nur EPUB-Bücher werden synchronisiert.
Halten Sie Komga an, archivieren Sie den Ordner config, starten Sie es wieder und senden Sie das Archiv außerhalb des Servers. Bewahren Sie auch eine Kopie Ihrer Bücher auf. Legen Sie direkt vor jedem Update eine Kopie an.
Ein Managed VPS deckt den Server ab: System, Sicherheit, Überwachung und Backups. Unsere Teams betreuen auch Ihre Instanz proaktiv und empfehlen Ihnen die sinnvollen Korrekturen, die Sie umsetzen. Ein Eingriff in der Anwendung wird nach Stunden oder pauschal abgerechnet.
Simafri
Sprechen wir über Ihr Vorhaben
Sagen Sie uns in wenigen Worten, was Sie brauchen: Wir melden uns schnell bei Ihnen.
Vielen Dank! Ihre Anfrage wurde gesendet. Wir melden uns in Kürze bei Ihnen.
Sie schreiben lieber eine E-Mail? Schreiben Sie uns an support@simafri.com.