Ospitare Komga su un VPS gestito significa leggere i vostri fumetti, i vostri manga e i vostri ebook da una macchina tutta vostra, che i nostri team tengono aggiornata e supervisionano giorno e notte. Komga è un media server libero con licenza MIT. Questa guida segue la sua documentazione ufficiale: la memoria e lo storage da prevedere, l'installazione con Docker Compose, il primo account, la configurazione, HTTPS, le biblioteche, la lettura tramite OPDS, Kobo e KOReader, i backup e gli aggiornamenti.
Di Simon Vasconcelos Lee
Pubblicato il 22 novembre 2026Lettura: 15 minuti
/data; il database, l'indice e i log risiedono in /config, su un disco locale.gotson/komga, la porta 25600 pubblicata in locale dietro un reverse proxy in HTTPS, e un utente proprietario delle due cartelle./config fuori dal server, conservate una copia dei vostri libri e aggiornate con docker compose pull.Komga è un media server per i vostri fumetti, manga, fumetti franco-belgi, riviste ed ebook. Gli indicate le cartelle che contengono i vostri file, lui li organizza in biblioteche, serie e libri, poi li serve a un browser o a un'app di lettura. Gira ovunque giri Java o Docker.
Komga è pubblicato con la licenza MIT, a nome di Gauthier Roebroeck. Concede gratuitamente il diritto di usare, copiare, modificare, unire, pubblicare, distribuire, concedere in sublicenza e vendere copie del software. Potete quindi farlo girare per voi, la vostra famiglia, la vostra associazione o la vostra azienda, senza alcuna licenza da acquistare.
L'unica condizione è conservare l'avviso di copyright e il testo della licenza in tutte le copie o le parti sostanziali del software. Il testo fornisce il software «così com'è», senza garanzia.
La documentazione non fissa alcuna configurazione minima. Fornisce invece ciò che conta per dimensionare il server: la memoria della macchina virtuale Java, le attività che impegnano la CPU e, soprattutto, lo spazio occupato dai vostri file.
OutOfMemoryException nei log. Il limite si alza allora con la variabile JAVA_TOOL_OPTIONS, presentata più avanti.La CPU lavora soprattutto durante le scansioni e le analisi delle biblioteche. Per ciascuna, la documentazione avverte che il calcolo degli hash dei file, degli hash delle pagine e degli hash per KOReader, così come l'analisi delle dimensioni delle pagine, può richiedere molte risorse su una grande biblioteca. Il numero di thread dedicati alle attività in background si imposta in «Server Settings».
È la voce più pesante, e si misura dalla vostra parte: le dimensioni della vostra collezione, più lo spazio per i libri che prevedete di aggiungere. Komga legge i vostri file dove si trovano e non li copia. Alcuni punti della documentazione cambiano il calcolo:
/data per i libri e le importazioni: la documentazione chiede di collocarvi le vostre biblioteche e la vostra cartella di importazione, perché le importazioni creino hard link invece di copie. Fuori dallo stesso filesystem, ogni importazione occupa lo spazio di una copia./config conserva il database principale, con le miniature generate per ogni libro, il database delle attività, quello delle sessioni, l'indice di ricerca e i log, che la configurazione predefinita conserva per 7 giorni e limita a 1 GB. Cresce con le dimensioni delle vostre biblioteche./config: i database SQLite non devono mai trovarsi su una condivisione di rete come CIFS o NFS. Komga lo verifica all'avvio e si arresta se non è così.Su un VPS gestito, parlateci della vostra collezione, delle sue dimensioni, del suo ritmo di crescita e del numero di lettori, e vi raccomandiamo la taglia adatta.
La documentazione pubblica l'immagine gotson/komga su Docker Hub e su ghcr.io, per processori amd64, arm64 e arm. Su un server in cui Docker è installato, create una cartella per Komga con le sue due sottocartelle, e annotate il vostro ID utente:
mkdir -p ~/komga/config ~/komga/data/import
cd ~/komga
id
Collocatevi questo compose.yaml, tratto dall'esempio della documentazione. Sostituite 1000:1000 con i valori uid e gid mostrati da id, e TZ con il vostro fuso orario:
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: è la principale differenza rispetto all'esempio della documentazione, che la pubblica su tutti gli indirizzi. La documentazione raccomanda vivamente HTTPS non appena Komga si apre fuori dalla vostra rete locale, perché usa l'autenticazione HTTP basic. L'interfaccia si raggiunge allora solo tramite il reverse proxy.user. La documentazione chiede che le cartelle montate appartengano a questo stesso utente: i problemi di permessi scompaiono così./config conserva il database e la configurazione di Komga, su un disco locale./data contiene i vostri libri e la vostra cartella di importazione. Ogni biblioteca vi avrà la propria sottocartella.1.x segue l'ultima versione 1 pubblicata; 1.30.1 fissa una versione. La documentazione riserva latest all'ultimo commit.version dell'esempio della documentazione è omessa: Docker Compose oggi la considera obsoleta e la ignora.L'altra strada della documentazione per un server Linux è il file jar di ogni versione, pubblicato su GitHub. Richiede Java 17 o successivo, e conserva la sua configurazione in ~/.komga:
java -version
java -jar komga-1.30.1.jar
Al primo accesso, Komga chiede di creare un account: un indirizzo e-mail e una password. Questo primo account riceve tutti i ruoli, amministrazione compresa, e «rivendica» il server. Finché non esiste, questo modulo risponde a chiunque raggiunga la pagina: createlo prima di aprire il server al pubblico, tramite un tunnel SSH. La porta 25600 del server compare allora sul vostro computer, su http://localhost:25600. Aggiungete -p e la porta SSH indicata nella vostra area clienti.
ssh -L 25600:127.0.0.1:25600 user@komga.example.com
Gli account successivi li crea l'amministratore, in «Server Settings», «Users», con il pulsante +. Ogni account riceve i ruoli di cui ha bisogno:
| Ruolo | Che cosa consente |
|---|---|
| Administrator | Gestire le biblioteche, gli utenti e le raccolte, modificare i metadati, avviare le scansioni, le analisi e gli aggiornamenti dei metadati |
| Page Streaming | Leggere pagina per pagina, nel lettore web per esempio |
| File Download | Scaricare il file di un libro |
| Kobo Sync | Sincronizzare un e-reader Kobo, insieme a File Download |
| KOReader Sync | Sincronizzare i progressi di lettura con KOReader |
Eliminare un utente cancella tutti i suoi progressi di lettura, senza possibilità di ritorno: una copia di /config fatta subito prima vi lascia il controllo.
La documentazione aggiunge il comando al compose.yaml, sotto il servizio komga; Komga applica la modifica, poi si avvia normalmente. Riavviate il servizio, poi togliete la riga e riavviatelo ancora una volta:
command: --newpassword=YourNewPassword --reset=admin@example.org
docker compose up -d
Il comando --list-users, usato allo stesso modo, mostra nei log l'elenco degli account.
Komga ha valori predefiniti per ogni impostazione: la configurazione serve solo a modificarne il comportamento. Si fa con variabili d'ambiente, la strada più semplice con Docker Compose, o con un file application.yml da creare nella cartella /config, dove l'immagine Docker lo carica. Per passare dal nome di una proprietà a quello di una variabile, sostituite i punti con trattini bassi, togliete i trattini e passate alle maiuscole.
| Variabile | Proprietà | Predefinito | A che cosa serve |
|---|---|---|---|
SERVER_PORT | server.port | 25600 | La porta dell'API e dell'interfaccia web |
SERVER_SERVLET_CONTEXTPATH | server.servlet.context-path | / | L'URL di base, per servire Komga in una sottocartella |
SPRING_SESSION_TIMEOUT | spring.session.timeout | 7 giorni | La durata di una sessione inattiva, per esempio 14d o 24h |
KOMGA_CORS_ALLOWEDORIGINS | komga.cors.allowed-origins | Nessuna | Le origini consentite per CORS |
LOGGING_LEVEL_ORG_GOTSON_KOMGA | logging.level.org.gotson.komga | Non impostato | DEBUG per log dettagliati |
La porta e l'URL di base si impostano anche in «Server Settings», e questa impostazione prevale allora sulla configurazione. Per la memoria di Java, aggiungete la variabile JAVA_TOOL_OPTIONS alla sezione environment. L'esempio della documentazione fissa un massimo di 4 GB:
- JAVA_TOOL_OPTIONS=-Xmx4g
L'esempio di application.yml della documentazione inizia con il percorso del database. Con Docker, lasciatelo su /config/database.sqlite, il suo valore predefinito: altrove, il database verrebbe creato nel container e perso alla sua ricreazione. Dell'esempio tenete solo le righe che vi servono.
La documentazione raccomanda di porre davanti a Komga un reverse proxy che ottenga un certificato valido, e suggerisce Caddy, che genera da solo i suoi certificati Let's Encrypt. Il proxy deve impostare tre intestazioni, perché Komga conosca l'indirizzo pubblico e il protocollo di ogni richiesta:
X-Forwarded-For, impostata o integrata;X-Forwarded-Proto;X-Forwarded-Host.Su un sottodominio, senza URL di base in Komga, Caddy imposta queste intestazioni da solo:
komga.example.com {
reverse_proxy 127.0.0.1:25600
}
In una sottocartella, impostate prima l'URL di base di Komga su /komga, in «Server Settings» o con SERVER_SERVLET_CONTEXTPATH, poi:
example.com {
reverse_proxy /komga/* 127.0.0.1:25600
}
L'esempio Nginx della documentazione inoltra anche le connessioni WebSocket. Aggiungete questo blocco map alla sezione http di /etc/nginx/nginx.conf:
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
Questo blocco del sito riprende le impostazioni dell'esempio della documentazione, sulla porta 80 per lasciare a Certbot l'attivazione di HTTPS. La riga X-Forwarded-Host è aggiunta, perché l'elenco delle intestazioni della documentazione la richiede:
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
L'esempio completo della documentazione mostra la versione finale: la porta 80 reindirizzata su HTTPS, e il blocco sulla 443 con i percorsi dei certificati.
Una biblioteca è un gruppo di libri, raccolto sotto una cartella radice. Komga crea una serie per ogni sottocartella, a qualsiasi profondità, e un libro per ogni file, collocato nella serie della sua cartella madre. I metadati dei file EPUB e dei file ComicInfo.xml contenuti negli archivi prevalgono sui nomi di cartelle e file.
~/komga/data per biblioteca, via SFTP o con rsync./data/manga, poi fate clic su «Add».rsync -av manga/ user@komga.example.com:komga/data/manga/
/data/manga e /data/comics convivono; /data e /data/manga, no.#recycle.Un libro il cui file scompare passa nel cestino, contrassegnato come «Unavailable», invece di essere eliminato: i suoi metadati, i suoi progressi di lettura e le sue liste tornano se il file ricompare al suo posto. Potete quindi rinominare e spostare i vostri file senza perdere nulla. Il cestino si svuota a mano, o dopo ogni scansione se attivate questa opzione, che allora elimina subito gli elementi.
La schermata «Import», «Books» colloca nelle vostre serie libri che si trovano in un'altra cartella del server, /data/import per esempio. Per ogni file, scegliete la serie di destinazione, il numero e il nome; un numero già usato propone di sostituire il libro esistente, mostrando i due affiancati. Komga sposta i file, o crea hard link quando il filesystem lo consente, e altrimenti li copia.
Cambiare la cartella radice di una biblioteca con un percorso senza relazione con il precedente cancella le sue serie, i suoi libri e i suoi progressi di lettura. Le FAQ descrivono come spostarla: hash dei file attivi, svuotamento automatico del cestino disattivato, poi una scansione prima dello spostamento.
Il lettore web si apre nel browser, all'indirizzo del server. Per un'app o un e-reader, Komga offre tre porte, tutte da servire in HTTPS.
Komga funziona con qualsiasi app OPDS, versione 1 o 2. Indicate all'app uno di questi indirizzi, poi l'indirizzo e-mail e la password del vostro account Komga:
https://komga.example.com/opds/v2/catalog
https://komga.example.com/opds/v1.2/catalog
Il catalogo in versione 1.2 aggiunge la ricerca per serie, tramite OpenSearch, e la lettura pagina per pagina senza download, tramite l'estensione OPDS PSE. La documentazione tiene un elenco delle app provate, su Android, iOS e altrove, con ciò che ciascuna supporta.
Il vostro e-reader Kobo si sincronizza con Komga al posto dei server ufficiali di Kobo. I libri EPUB di tutte le biblioteche arrivano con i loro metadati e la loro copertina, convertiti in KEPUB al volo da Kepubify, incluso nell'immagine Docker. I progressi di lettura si sincronizzano nei due sensi.
.kobo/Kobo/Kobo eReader.conf, con i file nascosti visibili.[OneStoreServices], sostituite la riga api_endpoint con l'indirizzo del vostro server seguito dalla vostra chiave.api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY
api_endpoint, 443 per un indirizzo in HTTPS.KOReader legge Komga tramite OPDS, e sincronizza i suoi progressi di lettura tramite il server di sincronizzazione di Komga:
https://komga.example.com/koreader.Tutto ciò che Komga sa dei vostri libri risiede in /config; i vostri libri, invece, restano in /data. Ecco che cosa contiene /config con la configurazione predefinita:
| Elemento | Che cosa conserva |
|---|---|
database.sqlite | Il database principale: biblioteche, serie, libri, metadati, utenti, progressi di lettura, raccolte, liste di lettura e miniature generate |
tasks.sqlite | Le attività in background in attesa |
sessions.sqlite | Le sessioni di accesso, conservate nel database per impostazione predefinita dalla versione 1.30.0 |
lucene/ | L'indice di ricerca |
fonts/ | I font |
logs/ | I log, tra cui komga.log |
application.yml | La vostra configurazione, se l'avete creata |
I database SQLite si copiano a Komga fermo, per una copia coerente. Dalla cartella del compose.yaml:
docker compose stop
tar -czf komga-config-$(date +%F).tar.gz config
docker compose start
Inviate questo archivio fuori dal server, al ritmo delle vostre aggiunte e delle vostre letture. Conservate anche una copia dei vostri libri, con le copertine che tenete accanto ai file: è il volume più pesante, ma cambia poco, e rsync invia solo le novità. Collocati sul disco del server, questi archivi rientrano anche nei suoi backup notturni.
Per ripristinare, fermate Komga, sostituite la cartella config con quella dell'archivio, verificate che appartenga ancora all'utente del compose.yaml, poi riavviatelo.
Con Docker Compose, la documentazione fornisce questi comandi, da lanciare dalla cartella del compose.yaml. La cartella /config, montata dal server, conserva le vostre impostazioni:
docker compose pull
docker compose up -d
docker image prune
/config subito prima di ogni aggiornamento.jar, fermate Komga, poi avviatelo con il jar della nuova versione.Il self-hosting richiede di occuparsi del server oltre che dell'applicazione. Su un VPS gestito, i nostri team prendono in carico il server e seguono la vostra istanza in modo proattivo; Komga resta il vostro software, con le sue impostazioni e i vostri libri.
| Argomento | I nostri team | Voi |
|---|---|---|
| Il server | Aggiornamenti del sistema e della sicurezza, interventi sul server compresi | Il momento più adatto alla vostra attività |
| La supervisione | Server seguito 24 ore su 24, 7 giorni su 7, con intervento senza attendere la vostra chiamata | La lettura dei log della vostra istanza |
| Komga | Monitoraggio proattivo: errori, rallentamenti, memoria e spazio su disco individuati, correzione raccomandata | La sua installazione, i suoi aggiornamenti e le sue impostazioni, che applicate voi o il vostro assistente IA |
| Le biblioteche e i lettori | Il server che le ospita, sorvegliato e salvato | Le biblioteche, gli account, i ruoli e le chiavi API |
| I backup | Ogni notte, cifrati e conservati fuori dalla macchina; ripristino compreso | Le copie proprie di Komga e la richiesta di ripristino, quando ne avete bisogno |
| La migrazione | Il vostro server attuale migrato, in omaggio | Il momento del passaggio |
Se preferite che i nostri team intervengano nell'applicazione stessa, questa prestazione si fattura a ore o a forfait, con un preventivo comunicato prima dell'intervento.
Con un VPS gestito Simafri, i nostri team tengono aggiornato il server della vostra istanza Komga, lo sorvegliano giorno e notte e intervengono senza attendere la vostra chiamata; seguono anche la vostra istanza in modo proattivo e vi raccomandano le correzioni utili, che applicate voi o il vostro assistente IA. I backup sono cifrati ogni notte e conservati fuori dalla macchina, il loro ripristino è compreso e la migrazione del vostro server attuale è in omaggio.
Sì. Komga ha licenza MIT: potete usarlo, modificarlo e ridistribuirlo in azienda senza alcuna licenza da acquistare, a condizione di conservarne l'avviso di copyright. Resta il costo del server che lo fa girare.
La documentazione non fissa alcun minimo. Per impostazione predefinita, Java limita la memoria di Komga, di solito intorno a 1 GB. Se i log mostrano errori OutOfMemoryException, alzate il limite con JAVA_TOOL_OPTIONS, per esempio -Xmx4g per 4 GB.
Create un compose.yaml con l'immagine gotson/komga, la porta 25600 pubblicata su 127.0.0.1, una cartella config montata su /config, una cartella data montata su /data e un utente proprietario di entrambe, poi lanciate docker compose up -d. Collocate quindi un reverse proxy in HTTPS davanti alla porta 25600.
Al primo accesso, Komga chiede un indirizzo e-mail e una password: questo primo account riceve tutti i ruoli. Createlo tramite un tunnel SSH prima di aprire il server al pubblico, poi create gli altri account in Server Settings, Users.
L'indirizzo del vostro server seguito da /opds/v2/catalog per OPDS 2, o da /opds/v1.2/catalog per OPDS 1.2, con l'indirizzo e-mail e la password del vostro account Komga.
Date all'account i ruoli Kobo Sync e File Download, generate una chiave API in Account Settings, poi sostituite la riga api_endpoint del file Kobo eReader.conf con https://your-server/kobo/your-key. Vengono sincronizzati solo i libri EPUB.
Fermate Komga, archiviate la cartella config, riavviatelo e inviate l'archivio fuori dal server. Conservate anche una copia dei vostri libri. Fate una copia subito prima di ogni aggiornamento.
Un VPS gestito copre il server: sistema, sicurezza, supervisione e backup. I nostri team seguono anche la vostra istanza in modo proattivo e vi raccomandano le correzioni utili, che applicate voi. Un intervento nell'applicazione si fattura a ore o a forfait.
Simafri
Parliamo del vostro progetto
Diteci in due parole ciò che vi serve: vi rispondiamo rapidamente.
Grazie! La tua richiesta è stata inviata. Ti risponderemo a breve.
Preferite l'email? Scriveteci a support@simafri.com.