Alojar Komga en un VPS administrado significa leer sus cómics, sus mangas y sus libros electrónicos desde una máquina propia, que nuestros equipos mantienen actualizada y supervisan día y noche. Komga es un servidor multimedia libre con licencia MIT. Esta guía sigue su documentación oficial: la memoria y el almacenamiento que hay que prever, la instalación con Docker Compose, la primera cuenta, la configuración, HTTPS, las bibliotecas, la lectura por OPDS, Kobo y KOReader, las copias de seguridad y las actualizaciones.
Por Simon Vasconcelos Lee
Publicado el 22 de noviembre de 202615 minutos de lectura
/data; la base de datos, el índice y los registros viven en /config, en un disco local.gotson/komga, el puerto 25600 publicado en local detrás de un proxy inverso en HTTPS, y un usuario propietario de las dos carpetas./config fuera del servidor, conserve una copia de sus libros y actualice con docker compose pull.Komga es un servidor multimedia para sus cómics, sus mangas, sus cómics franco-belgas, sus revistas y sus libros electrónicos. Usted le indica las carpetas donde están sus archivos, él los organiza en bibliotecas, series y libros, y después los sirve a un navegador o a una aplicación de lectura. Funciona en cualquier lugar donde funcione Java o Docker.
Komga se publica bajo la licencia MIT, a nombre de Gauthier Roebroeck. Concede, de forma gratuita, el derecho a usar, copiar, modificar, fusionar, publicar, distribuir, sublicenciar y vender copias del software. Puede, por tanto, ejecutarlo para usted, su familia, su asociación o su empresa, sin ninguna licencia que comprar.
La única condición es conservar el aviso de copyright y el texto de la licencia en todas las copias o partes sustanciales del software. El texto ofrece el software «tal cual», sin garantía.
La documentación no fija ninguna configuración mínima. Da, eso sí, lo que cuenta para dimensionar el servidor: la memoria de la máquina virtual Java, las tareas que usan el procesador y, sobre todo, el espacio que ocupan sus archivos.
OutOfMemoryException en los registros. El límite se eleva entonces con la variable JAVA_TOOL_OPTIONS, que se presenta más abajo.El procesador trabaja sobre todo durante los escaneos y los análisis de las bibliotecas. Para cada una, la documentación advierte de que calcular los hashes de archivos, los hashes de páginas y los hashes de KOReader, al igual que analizar las dimensiones de las páginas, puede consumir muchos recursos en una biblioteca grande. El número de hilos dedicados a las tareas en segundo plano se ajusta en «Server Settings».
Es la partida más pesada, y se mide por su lado: el tamaño de su colección, más espacio para los libros que piensa añadir. Komga lee sus archivos donde están y no los copia. Algunos puntos de la documentación cambian el cálculo:
/data para los libros y las importaciones: la documentación pide colocar ahí sus bibliotecas y su carpeta de importación, para que las importaciones creen enlaces físicos en lugar de copias. Fuera del mismo sistema de archivos, cada importación ocupa el espacio de una copia./config guarda la base de datos principal, con las miniaturas generadas para cada libro, la base de datos de tareas, la de sesiones, el índice de búsqueda y los registros, que la configuración por defecto conserva 7 días y limita a 1 GB. Crece con el tamaño de sus bibliotecas./config: las bases de datos SQLite nunca deben estar en un recurso compartido de red como CIFS o NFS. Komga lo comprueba al arrancar y se detiene si no es así.En un VPS administrado, cuéntenos cómo es su colección, su tamaño, su ritmo de crecimiento y el número de lectores, y le recomendamos el tamaño adecuado.
La documentación publica la imagen gotson/komga en Docker Hub y en ghcr.io, para procesadores amd64, arm64 y arm. En un servidor con Docker instalado, cree una carpeta para Komga con sus dos subcarpetas, y anote su identificador de usuario:
mkdir -p ~/komga/config ~/komga/data/import
cd ~/komga
id
Coloque en ella este compose.yaml, tomado del ejemplo de la documentación. Sustituya 1000:1000 por los valores uid y gid que muestra id, y TZ por su zona horaria:
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: es el principal cambio respecto al ejemplo de la documentación, que lo publica en todas las direcciones. La documentación recomienda encarecidamente HTTPS en cuanto Komga se abre fuera de su red local, porque usa la autenticación HTTP básica. La interfaz solo es accesible entonces a través del proxy inverso.user. La documentación pide que las carpetas montadas pertenezcan a ese mismo usuario: así desaparecen los problemas de permisos./config guarda la base de datos y la configuración de Komga, en un disco local./data contiene sus libros y su carpeta de importación. Cada biblioteca tendrá ahí su propia subcarpeta.1.x sigue la última versión 1 publicada; 1.30.1 fija una versión. La documentación reserva latest para el último commit.version del ejemplo de la documentación se omite: Docker Compose la considera hoy obsoleta y la ignora.La otra vía de la documentación para un servidor Linux es el archivo jar de cada versión, publicado en GitHub. Necesita Java 17 o posterior, y guarda su configuración en ~/.komga:
java -version
java -jar komga-1.30.1.jar
En el primer acceso, Komga pide crear una cuenta: una dirección de correo electrónico y una contraseña. Esa primera cuenta recibe todos los roles, administración incluida, y «reclama» el servidor. Mientras no exista, este formulario responde a cualquiera que llegue a la página: créela antes de abrir el servidor al público, a través de un túnel SSH. El puerto 25600 del servidor aparece entonces en su ordenador, en http://localhost:25600. Añada -p y el puerto SSH que figura en su área de cliente.
ssh -L 25600:127.0.0.1:25600 user@komga.example.com
Las cuentas siguientes las crea el administrador, en «Server Settings», «Users», con el botón +. Cada cuenta recibe los roles que necesita:
| Rol | Lo que permite |
|---|---|
| Administrator | Gestionar las bibliotecas, los usuarios y las colecciones, editar los metadatos, lanzar los escaneos, los análisis y las actualizaciones de metadatos |
| Page Streaming | Leer página a página, en el lector web por ejemplo |
| File Download | Descargar el archivo de un libro |
| Kobo Sync | Sincronizar un lector Kobo, junto con File Download |
| KOReader Sync | Sincronizar el progreso de lectura con KOReader |
Eliminar un usuario borra todo su progreso de lectura, sin vuelta atrás: una copia de /config hecha justo antes le permite conservar el control.
La documentación añade el comando al compose.yaml, en el servicio komga; Komga aplica el cambio y después arranca con normalidad. Reinicie el servicio, después retire la línea y reinícielo una vez más:
command: --newpassword=YourNewPassword --reset=admin@example.org
docker compose up -d
El comando --list-users, usado de la misma forma, muestra en los registros la lista de cuentas.
Komga tiene valores por defecto para cada ajuste: la configuración solo sirve para cambiar su comportamiento. Se hace con variables de entorno, la vía más sencilla con Docker Compose, o con un archivo application.yml que se crea en la carpeta /config, donde la imagen Docker lo carga. Para pasar del nombre de una propiedad al de una variable, sustituya los puntos por guiones bajos, quite los guiones y pase a mayúsculas.
| Variable | Propiedad | Por defecto | Para qué sirve |
|---|---|---|---|
SERVER_PORT | server.port | 25600 | El puerto de la API y de la interfaz web |
SERVER_SERVLET_CONTEXTPATH | server.servlet.context-path | / | La URL base, para servir Komga en una subcarpeta |
SPRING_SESSION_TIMEOUT | spring.session.timeout | 7 días | La duración de una sesión inactiva, por ejemplo 14d o 24h |
KOMGA_CORS_ALLOWEDORIGINS | komga.cors.allowed-origins | Ninguno | Los orígenes autorizados para CORS |
LOGGING_LEVEL_ORG_GOTSON_KOMGA | logging.level.org.gotson.komga | Sin definir | DEBUG para registros detallados |
El puerto y la URL base también se ajustan en «Server Settings», y ese ajuste prevalece entonces sobre la configuración. Para la memoria de Java, añada la variable JAVA_TOOL_OPTIONS a la sección environment. El ejemplo de la documentación fija un máximo de 4 GB:
- JAVA_TOOL_OPTIONS=-Xmx4g
El ejemplo de application.yml de la documentación empieza por la ruta de la base de datos. Con Docker, manténgala en /config/database.sqlite, su valor por defecto: en cualquier otro lugar, la base de datos se crearía dentro del contenedor y se perdería al recrearlo. Conserve del ejemplo solo las líneas que necesite.
La documentación recomienda colocar delante de Komga un proxy inverso que obtenga un certificado válido, y sugiere Caddy, que genera por sí mismo sus certificados de Let’s Encrypt. El proxy debe definir tres cabeceras, para que Komga conozca la dirección pública y el protocolo de cada petición:
X-Forwarded-For, definida o completada;X-Forwarded-Proto;X-Forwarded-Host.En un subdominio, sin URL base en Komga, Caddy define estas cabeceras por sí mismo:
komga.example.com {
reverse_proxy 127.0.0.1:25600
}
En una subcarpeta, ajuste primero la URL base de Komga en /komga, en «Server Settings» o con SERVER_SERVLET_CONTEXTPATH, y después:
example.com {
reverse_proxy /komga/* 127.0.0.1:25600
}
El ejemplo Nginx de la documentación también transmite las conexiones WebSocket. Añada este bloque map a la sección http de /etc/nginx/nginx.conf:
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
Este bloque de sitio retoma los ajustes del ejemplo de la documentación, en el puerto 80 para que Certbot pueda instalar HTTPS. Se añade la línea X-Forwarded-Host, ya que la lista de cabeceras de la documentación la pide:
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
El ejemplo completo de la documentación muestra la versión final: el puerto 80 redirigido a HTTPS, y el bloque en el 443 con las rutas de sus certificados.
Una biblioteca es un grupo de libros, guardado bajo una carpeta raíz. Komga crea una serie por cada subcarpeta, a cualquier profundidad, y un libro por cada archivo, colocado en la serie de su carpeta padre. Los metadatos de los archivos EPUB y de los archivos ComicInfo.xml incluidos en los archivos comprimidos prevalecen sobre los nombres de carpetas y de archivos.
~/komga/data por biblioteca, por SFTP o con rsync./data/manga, y haga clic en «Add».rsync -av manga/ user@komga.example.com:komga/data/manga/
/data/manga y /data/comics conviven; /data y /data/manga, no.#recycle.Un libro cuyo archivo desaparece pasa a la papelera, marcado como «Unavailable», en lugar de eliminarse: sus metadatos, su progreso de lectura y sus listas vuelven si el archivo reaparece en su sitio. Puede, por tanto, renombrar y mover sus archivos sin perder nada. La papelera se vacía a mano, o después de cada escaneo si activa esa opción, que entonces elimina los elementos de inmediato.
La pantalla «Import», «Books» coloca en sus series libros que están en otra carpeta del servidor, /data/import por ejemplo. Para cada archivo, usted elige la serie de destino, el número y el nombre; un número ya ocupado propone sustituir el libro existente, mostrando ambos uno al lado del otro. Komga mueve los archivos, o crea enlaces físicos cuando el sistema de archivos lo permite, y si no, los copia.
Cambiar la carpeta raíz de una biblioteca por una ruta sin relación con la anterior borra sus series, sus libros y su progreso de lectura. Las preguntas frecuentes describen cómo moverla: hashes de archivos activados, vaciado automático de la papelera desactivado, y un escaneo antes del traslado.
El lector web se abre en el navegador, en la dirección del servidor. Para una aplicación o un lector electrónico, Komga ofrece tres puertas, todas para servir en HTTPS.
Komga funciona con cualquier aplicación OPDS, versión 1 o 2. Indique a la aplicación una de estas direcciones, y después la dirección de correo electrónico y la contraseña de su cuenta de Komga:
https://komga.example.com/opds/v2/catalog
https://komga.example.com/opds/v1.2/catalog
El catálogo en versión 1.2 añade la búsqueda por serie, mediante OpenSearch, y la lectura página a página sin descarga, mediante la extensión OPDS PSE. La documentación mantiene una lista de aplicaciones probadas, en Android, iOS y otros sistemas, con lo que admite cada una.
Su lector Kobo se sincroniza con Komga en lugar de con los servidores oficiales de Kobo. Los libros EPUB de todas las bibliotecas llegan con sus metadatos y su portada, convertidos a KEPUB sobre la marcha por Kepubify, incluido en la imagen Docker. El progreso de lectura se sincroniza en ambos sentidos.
.kobo/Kobo/Kobo eReader.conf, con los archivos ocultos visibles.[OneStoreServices], sustituya la línea api_endpoint por la dirección de su servidor seguida de su clave.api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY
api_endpoint, 443 para una dirección en HTTPS.KOReader lee Komga por OPDS, y sincroniza su progreso de lectura a través del servidor de sincronización de Komga:
https://komga.example.com/koreader.Todo lo que Komga sabe de sus libros vive en /config; sus libros, en cambio, permanecen en /data. Esto es lo que contiene /config con la configuración por defecto:
| Elemento | Lo que guarda |
|---|---|
database.sqlite | La base de datos principal: bibliotecas, series, libros, metadatos, usuarios, progreso de lectura, colecciones, listas de lectura y miniaturas generadas |
tasks.sqlite | Las tareas en segundo plano pendientes |
sessions.sqlite | Las sesiones de inicio de sesión, guardadas en la base de datos por defecto desde la versión 1.30.0 |
lucene/ | El índice de búsqueda |
fonts/ | Las fuentes tipográficas |
logs/ | Los registros, incluido komga.log |
application.yml | Su configuración, si la ha creado |
Las bases de datos SQLite se copian con Komga detenido, para obtener una copia coherente. Desde la carpeta del compose.yaml:
docker compose stop
tar -czf komga-config-$(date +%F).tar.gz config
docker compose start
Envíe este archivo fuera del servidor, al ritmo de sus incorporaciones y de sus lecturas. Conserve también una copia de sus libros, con las portadas que guarda junto a los archivos: es el volumen más pesado, pero cambia poco, y rsync solo envía lo nuevo. Guardados en el disco del servidor, estos archivos entran también en sus copias de seguridad nocturnas.
Para restaurar, detenga Komga, sustituya la carpeta config por la del archivo, compruebe que sigue perteneciendo al usuario del compose.yaml, y vuelva a arrancarlo.
Con Docker Compose, la documentación da estos comandos, desde la carpeta del compose.yaml. La carpeta /config, montada desde el servidor, conserva sus ajustes:
docker compose pull
docker compose up -d
docker image prune
/config justo antes de cada actualización.jar, detenga Komga y después arránquelo con el jar de la nueva versión.El autoalojamiento exige mantener el servidor además de la aplicación. En un VPS administrado, nuestros equipos se encargan del servidor y siguen su instancia de forma proactiva; Komga sigue siendo su software, con sus ajustes y sus libros.
| Tema | Nuestros equipos | Usted |
|---|---|---|
| El servidor | Actualizaciones del sistema y de seguridad, con intervenciones en el servidor incluidas | El momento que mejor convenga a su actividad |
| La supervisión | Servidor vigilado las 24 horas del día, los 7 días de la semana, con intervención sin esperar su llamada | La lectura de los registros de su instancia |
| Komga | Seguimiento proactivo: errores, lentitud, memoria y espacio en disco detectados, corrección recomendada | Su instalación, sus actualizaciones y sus ajustes, que aplica usted o su asistente de IA |
| Las bibliotecas y los lectores | El servidor que las soporta, vigilado y con copias de seguridad | Las bibliotecas, las cuentas, los roles y las claves de API |
| Las copias de seguridad | Cada noche, cifradas y guardadas fuera de la máquina; restauración incluida | Las copias propias de Komga, y la petición de restauración, cuando la necesite |
| La migración | Su servidor actual migrado, gratis | El momento del cambio |
Si prefiere que nuestros equipos intervengan en la propia aplicación, ese servicio se factura por horas o a precio cerrado, con un presupuesto comunicado antes de la intervención.
Con un VPS administrado de Simafri, nuestros equipos mantienen actualizado el servidor de su instancia de Komga, lo vigilan día y noche e intervienen sin esperar su llamada; también siguen su instancia de forma proactiva y le recomiendan las correcciones útiles, que aplica usted o su asistente de IA. Las copias de seguridad se cifran cada noche y se guardan fuera de la máquina, su restauración está incluida, y la migración de su servidor actual es gratuita.
Sí. Komga tiene licencia MIT: puede usarlo, modificarlo y redistribuirlo en su empresa sin ninguna licencia que comprar, siempre que conserve su aviso de copyright. Queda el coste del servidor que lo ejecuta.
La documentación no fija ningún mínimo. Por defecto, Java limita la memoria de Komga, normalmente en torno a 1 GB. Si los registros muestran errores OutOfMemoryException, eleve el límite con JAVA_TOOL_OPTIONS, por ejemplo -Xmx4g para 4 GB.
Cree un compose.yaml con la imagen gotson/komga, el puerto 25600 publicado en 127.0.0.1, una carpeta config montada en /config, una carpeta data montada en /data y un usuario propietario de ambas, y ejecute docker compose up -d. Coloque después delante del puerto 25600 un proxy inverso en HTTPS.
En el primer acceso, Komga pide una dirección de correo electrónico y una contraseña: esa primera cuenta recibe todos los roles. Créela a través de un túnel SSH antes de abrir el servidor al público, y cree después las demás cuentas en Server Settings, Users.
La dirección de su servidor seguida de /opds/v2/catalog para OPDS 2, o de /opds/v1.2/catalog para OPDS 1.2, con la dirección de correo electrónico y la contraseña de su cuenta de Komga.
Dé a la cuenta los roles Kobo Sync y File Download, genere una clave de API en Account Settings y sustituya después la línea api_endpoint del archivo Kobo eReader.conf por https://su-servidor/kobo/su-clave. Solo se sincronizan los libros EPUB.
Detenga Komga, archive la carpeta config, vuelva a arrancarlo y envíe el archivo fuera del servidor. Conserve también una copia de sus libros. Haga una copia justo antes de cada actualización.
Un VPS administrado cubre el servidor: sistema, seguridad, supervisión y copias de seguridad. Nuestros equipos siguen también su instancia de forma proactiva y le recomiendan las correcciones útiles, que aplica usted. Una intervención en la aplicación se factura por horas o a precio cerrado.
Simafri
Hablemos de su proyecto
Díganos en pocas palabras lo que necesita: le respondemos rápidamente.
¡Gracias! Su solicitud ha sido enviada. Le responderemos en breve.
¿Prefiere el correo? Escríbanos a support@simafri.com.