Ospitare Komga su un VPS gestito: i vostri fumetti e manga sul vostro server

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.

Simon Vasconcelos Lee Di Pubblicato il 22 novembre 2026Lettura: 15 minuti

Tutte le guide

In breve

  1. La licenza MIT consente di usare, modificare e ridistribuire Komga liberamente, in azienda come altrove, a condizione di conservarne l'avviso di copyright.
  2. Lo storage si dimensiona sulla vostra collezione, conservata in /data; il database, l'indice e i log risiedono in /config, su un disco locale.
  3. Installatelo con Docker Compose: l'immagine gotson/komga, la porta 25600 pubblicata in locale dietro un reverse proxy in HTTPS, e un utente proprietario delle due cartelle.
  4. Il primo account creato diventa l'amministratore: createlo tramite un tunnel SSH prima di aprire il server al pubblico.
  5. Fermate Komga, copiate la cartella /config fuori dal server, conservate una copia dei vostri libri e aggiornate con docker compose pull.

Che cosa fa Komga

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.

Che cosa consente la licenza MIT

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.

Memoria, CPU e storage: dimensionare il server

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.

La memoria di Java

La CPU

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

Lo storage dei vostri libri

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

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.

L'installazione con Docker Compose

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:

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

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

Senza Docker: il file jar

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:

Terminale
java -version
java -jar komga-1.30.1.jar

Il primo account e gli utenti

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.

Terminale, sul vostro computer
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:

RuoloChe cosa consente
AdministratorGestire le biblioteche, gli utenti e le raccolte, modificare i metadati, avviare le scansioni, le analisi e gli aggiornamenti dei metadati
Page StreamingLeggere pagina per pagina, nel lettore web per esempio
File DownloadScaricare il file di un libro
Kobo SyncSincronizzare un e-reader Kobo, insieme a File Download
KOReader SyncSincronizzare 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.

Reimpostare una password dalla riga di comando

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:

compose.yaml, sotto il servizio komga
    command: --newpassword=YourNewPassword --reset=admin@example.org
Terminale
docker compose up -d

Il comando --list-users, usato allo stesso modo, mostra nei log l'elenco degli account.

La configurazione: variabili o application.yml

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.

VariabileProprietàPredefinitoA che cosa serve
SERVER_PORTserver.port25600La porta dell'API e dell'interfaccia web
SERVER_SERVLET_CONTEXTPATHserver.servlet.context-path/L'URL di base, per servire Komga in una sottocartella
SPRING_SESSION_TIMEOUTspring.session.timeout7 giorniLa durata di una sessione inattiva, per esempio 14d o 24h
KOMGA_CORS_ALLOWEDORIGINSkomga.cors.allowed-originsNessunaLe origini consentite per CORS
LOGGING_LEVEL_ORG_GOTSON_KOMGAlogging.level.org.gotson.komgaNon impostatoDEBUG 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:

compose.yaml, in environment
      - 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.

HTTPS e il reverse proxy

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:

Con Caddy

Su un sottodominio, senza URL di base in Komga, Caddy imposta queste intestazioni da solo:

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

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

Con Nginx

L'esempio Nginx della documentazione inoltra anche le connessioni WebSocket. Aggiungete questo blocco map alla sezione http di /etc/nginx/nginx.conf:

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

Blocco 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;
    }
}
Terminale
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.

Le biblioteche, le scansioni e le importazioni

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.

  1. Caricate i vostri file sul server, in una sottocartella di ~/komga/data per biblioteca, via SFTP o con rsync.
  2. Nell'interfaccia, fate clic su + accanto a «Libraries».
  3. Date un nome alla biblioteca, scegliete la sua cartella radice con «Browse», per esempio /data/manga, poi fate clic su «Add».
Terminale, sul vostro computer
rsync -av manga/ user@komga.example.com:komga/data/manga/

Il cestino

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.

L'importazione di libri

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.

Leggere ovunque: OPDS, Kobo e KOReader

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.

OPDS

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:

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

La sincronizzazione Kobo

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.

  1. Date all'account i ruoli Kobo Sync e File Download.
  2. Generate una chiave API nella pagina del vostro account, «Account Settings», e annotatela: viene mostrata una sola volta. Usate una chiave per e-reader.
  3. Collegate il Kobo al vostro computer e aprite il file .kobo/Kobo/Kobo eReader.conf, con i file nascosti visibili.
  4. Nel gruppo [OneStoreServices], sostituite la riga api_endpoint con l'indirizzo del vostro server seguito dalla vostra chiave.
Kobo eReader.conf
api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY

La sincronizzazione KOReader

KOReader legge Komga tramite OPDS, e sincronizza i suoi progressi di lettura tramite il server di sincronizzazione di Komga:

  1. Date all'account il ruolo KOReader Sync, e attivate gli hash dei file per KOReader nelle opzioni della biblioteca.
  2. Generate una chiave API nella pagina del vostro account.
  3. In KOReader, con un libro aperto, andate in «Progress sync», poi «Custom sync server», e inserite https://komga.example.com/koreader.
  4. In «Register / Login», inserite la chiave API come nome utente, e un valore qualsiasi come password, che Komga non usa.
  5. In «Document matching method», scegliete «Binary».

I backup

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:

ElementoChe cosa conserva
database.sqliteIl database principale: biblioteche, serie, libri, metadati, utenti, progressi di lettura, raccolte, liste di lettura e miniature generate
tasks.sqliteLe attività in background in attesa
sessions.sqliteLe 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.ymlLa vostra configurazione, se l'avete creata

I database SQLite si copiano a Komga fermo, per una copia coerente. Dalla cartella del compose.yaml:

Terminale, in ~/komga
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.

Gli aggiornamenti

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:

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

Chi fa che cosa su un VPS gestito

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.

ArgomentoI nostri teamVoi
Il serverAggiornamenti del sistema e della sicurezza, interventi sul server compresiIl momento più adatto alla vostra attività
La supervisioneServer seguito 24 ore su 24, 7 giorni su 7, con intervento senza attendere la vostra chiamataLa lettura dei log della vostra istanza
KomgaMonitoraggio proattivo: errori, rallentamenti, memoria e spazio su disco individuati, correzione raccomandataLa sua installazione, i suoi aggiornamenti e le sue impostazioni, che applicate voi o il vostro assistente IA
Le biblioteche e i lettoriIl server che le ospita, sorvegliato e salvatoLe biblioteche, gli account, i ruoli e le chiavi API
I backupOgni notte, cifrati e conservati fuori dalla macchina; ripristino compresoLe copie proprie di Komga e la richiesta di ripristino, quando ne avete bisogno
La migrazioneIl vostro server attuale migrato, in omaggioIl 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.

Komga, su un server gestito per voi

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.

Scoprire i VPS gestiti

Domande frequenti

Komga è gratuito per un'azienda?

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.

Di quanta memoria ha bisogno Komga?

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.

Come installare Komga con Docker Compose?

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.

Come creare l'account amministratore di Komga?

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.

Quale indirizzo OPDS indicare alla mia app di lettura?

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.

Come sincronizzare un e-reader Kobo con 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.

Come fare il backup di Komga?

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 Komga?

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.

Fonti e documentazione ufficiale

Contattaci