Alojar Komga en un VPS administrado: sus cómics y mangas en su servidor

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.

Simon Vasconcelos Lee Por Publicado el 22 de noviembre de 202615 minutos de lectura

Todas las guías

Lo esencial

  1. La licencia MIT permite usar, modificar y redistribuir Komga libremente, en una empresa o en cualquier otro ámbito, siempre que conserve su aviso de copyright.
  2. El almacenamiento se dimensiona según su colección, guardada en /data; la base de datos, el índice y los registros viven en /config, en un disco local.
  3. Instálelo con Docker Compose: la imagen gotson/komga, el puerto 25600 publicado en local detrás de un proxy inverso en HTTPS, y un usuario propietario de las dos carpetas.
  4. La primera cuenta creada se convierte en la de administrador: créela a través de un túnel SSH antes de abrir el servidor al público.
  5. Detenga Komga, copie la carpeta /config fuera del servidor, conserve una copia de sus libros y actualice con docker compose pull.

Qué hace Komga

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.

Lo que permite la licencia MIT

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.

Memoria, procesador y almacenamiento: dimensionar el servidor

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.

La memoria de Java

El procesador

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

El almacenamiento de sus libros

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:

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 instalación con Docker Compose

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:

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

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

Sin Docker: el archivo jar

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:

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

La primera cuenta y los usuarios

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.

Terminal, en su ordenador
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:

RolLo que permite
AdministratorGestionar las bibliotecas, los usuarios y las colecciones, editar los metadatos, lanzar los escaneos, los análisis y las actualizaciones de metadatos
Page StreamingLeer página a página, en el lector web por ejemplo
File DownloadDescargar el archivo de un libro
Kobo SyncSincronizar un lector Kobo, junto con File Download
KOReader SyncSincronizar 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.

Restablecer una contraseña desde la línea de comandos

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:

compose.yaml, en el servicio komga
    command: --newpassword=YourNewPassword --reset=admin@example.org
Terminal
docker compose up -d

El comando --list-users, usado de la misma forma, muestra en los registros la lista de cuentas.

La configuración: variables o application.yml

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.

VariablePropiedadPor defectoPara qué sirve
SERVER_PORTserver.port25600El puerto de la API y de la interfaz web
SERVER_SERVLET_CONTEXTPATHserver.servlet.context-path/La URL base, para servir Komga en una subcarpeta
SPRING_SESSION_TIMEOUTspring.session.timeout7 díasLa duración de una sesión inactiva, por ejemplo 14d o 24h
KOMGA_CORS_ALLOWEDORIGINSkomga.cors.allowed-originsNingunoLos orígenes autorizados para CORS
LOGGING_LEVEL_ORG_GOTSON_KOMGAlogging.level.org.gotson.komgaSin definirDEBUG 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:

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

HTTPS y el proxy inverso

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:

Con Caddy

En un subdominio, sin URL base en Komga, Caddy define estas cabeceras por sí mismo:

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

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

Con Nginx

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:

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

Bloque 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

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.

Las bibliotecas, los escaneos y las importaciones

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.

  1. Coloque sus archivos en el servidor, en una subcarpeta de ~/komga/data por biblioteca, por SFTP o con rsync.
  2. En la interfaz, haga clic en + junto a «Libraries».
  3. Dé un nombre a la biblioteca, elija su carpeta raíz con «Browse», por ejemplo /data/manga, y haga clic en «Add».
Terminal, en su ordenador
rsync -av manga/ user@komga.example.com:komga/data/manga/

La papelera

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 importación de libros

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.

Leer en cualquier lugar: OPDS, Kobo y KOReader

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.

OPDS

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:

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

La sincronización con Kobo

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.

  1. Dé a la cuenta los roles Kobo Sync y File Download.
  2. Genere una clave de API en la página de su cuenta, «Account Settings», y anótela: solo se muestra una vez. Use una clave por lector.
  3. Conecte el Kobo a su ordenador y abra el archivo .kobo/Kobo/Kobo eReader.conf, con los archivos ocultos visibles.
  4. En el grupo [OneStoreServices], sustituya la línea api_endpoint por la dirección de su servidor seguida de su clave.
Kobo eReader.conf
api_endpoint=https://komga.example.com/kobo/YOUR_API_KEY

La sincronización con KOReader

KOReader lee Komga por OPDS, y sincroniza su progreso de lectura a través del servidor de sincronización de Komga:

  1. Dé a la cuenta el rol KOReader Sync, y active los hashes de archivos para KOReader en las opciones de la biblioteca.
  2. Genere una clave de API en la página de su cuenta.
  3. En KOReader, con un libro abierto, vaya a «Progress sync», después a «Custom sync server», e introduzca https://komga.example.com/koreader.
  4. En «Register / Login», introduzca la clave de API como nombre de usuario, y cualquier valor como contraseña, que Komga no utiliza.
  5. En «Document matching method», elija «Binary».

Las copias de seguridad

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:

ElementoLo que guarda
database.sqliteLa base de datos principal: bibliotecas, series, libros, metadatos, usuarios, progreso de lectura, colecciones, listas de lectura y miniaturas generadas
tasks.sqliteLas tareas en segundo plano pendientes
sessions.sqliteLas 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.ymlSu 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:

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

Las actualizaciones

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:

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

Quién hace qué en un VPS administrado

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.

TemaNuestros equiposUsted
El servidorActualizaciones del sistema y de seguridad, con intervenciones en el servidor incluidasEl momento que mejor convenga a su actividad
La supervisiónServidor vigilado las 24 horas del día, los 7 días de la semana, con intervención sin esperar su llamadaLa lectura de los registros de su instancia
KomgaSeguimiento proactivo: errores, lentitud, memoria y espacio en disco detectados, corrección recomendadaSu instalación, sus actualizaciones y sus ajustes, que aplica usted o su asistente de IA
Las bibliotecas y los lectoresEl servidor que las soporta, vigilado y con copias de seguridadLas bibliotecas, las cuentas, los roles y las claves de API
Las copias de seguridadCada noche, cifradas y guardadas fuera de la máquina; restauración incluidaLas copias propias de Komga, y la petición de restauración, cuando la necesite
La migraciónSu servidor actual migrado, gratisEl 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.

Komga, en un servidor que cuidamos por usted

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.

Descubrir los VPS administrados

Preguntas frecuentes

¿Komga es gratuito para una empresa?

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.

¿Cuánta memoria necesita Komga?

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.

¿Cómo instalar Komga con Docker Compose?

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.

¿Cómo crear la cuenta de administrador de Komga?

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.

¿Qué dirección OPDS debo dar a mi aplicación de lectura?

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.

¿Cómo sincronizar un lector Kobo con 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.

¿Cómo hacer copia de seguridad de Komga?

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

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.

Fuentes y documentación oficial

Contáctenos