BookLore: Gestión self-hosted de bibliotecas digitales similar a Calibre
Introducción
Este artículo documenta la instalación básica de BookLore como servicio self-hosted para la gestión y lectura de bibliotecas digitales. BookLore se integra en el stack como aplicación web con estado, orientada a centralizar grandes colecciones de libros electrónicos y servirlos tanto vía interfaz web como mediante OPDS a clientes externos.
El servicio cumple un rol similar a Calibre / Calibre‑Web, con un enfoque más moderno y web‑first. Actualmente se está probando con una biblioteca real de aproximadamente 125 GB y cerca de 120 000 libros, funcionando de forma estable tanto en indexación como en servicio OPDS.
Enfoque general
El despliegue se mantiene deliberadamente simple:
- Un único servicio Docker.
- Persistencia completa de configuración y contenido.
- Acceso directo por HTTP o detrás de proxy inverso.
- Sin autenticación externa ni capas adicionales.
Este enfoque permite evaluar rendimiento, estabilidad y comportamiento con bibliotecas grandes antes de introducir integraciones más complejas.
Requisitos previos
-
Docker y Docker Compose operativos.
-
Espacio de almacenamiento suficiente para bibliotecas grandes.
-
Volúmenes persistentes para:
- Configuración y base de datos.
- Biblioteca de libros.
- Carpeta de importación automática (BookDrop).
Desarrollo
Qué se hizo y por qué
Se opta por la instalación oficial mediante Docker Compose por ser el método soportado por el proyecto y el que mejor encaja en entornos homelab.
Motivos principales:
- Separación clara entre aplicación y datos.
- Actualizaciones sencillas sin migraciones manuales.
- Capacidad para manejar bibliotecas grandes sin depender de herramientas externas.
- Exposición nativa de catálogo vía OPDS, evitando soluciones intermedias.
Durante las pruebas con una biblioteca de gran tamaño (≈120 000 libros), BookLore ha mostrado un comportamiento estable, sirviendo el catálogo de forma fluida tanto desde la interfaz web como desde clientes OPDS externos.
Un punto relevante observado es que BookLore puede utilizarse en paralelo con Calibre. Ambas aplicaciones pueden apuntar a las mismas carpetas físicas de biblioteca, sin necesidad de duplicar contenido. Por ejemplo, una carpeta llamada Linux puede actuar como biblioteca Linux tanto en Calibre como en BookLore, compartiendo exactamente los mismos libros y estructura.
Por lo probado hasta ahora, no es necesario mantener bibliotecas separadas para cada aplicación, lo que simplifica la gestión y evita duplicaciones de almacenamiento.
Características principales
BookLore comparte concepto con Calibre, pero amplía el enfoque hacia una experiencia web integrada:
- Gestión centralizada de bibliotecas digitales.
- Soporte para múltiples formatos (EPUB, PDF, CBZ, entre otros).
- Indexación automática de libros y metadatos.
- Edición manual de metadatos desde la interfaz web.
- Organización por autores, series, etiquetas y colecciones.
- Lector web integrado.
- Servicio OPDS para clientes externos y dispositivos de lectura.
- Importación automática mediante carpeta BookDrop.
- Soporte multiusuario con control básico de cuentas.
- Interfaz moderna orientada a uso continuo desde navegador.
Configuración utilizada (solo enlaces)
La configuración completa se mantiene versionada en Gitea:
Validación
Comprobaciones realizadas tras el despliegue:
- Contenedor estable en ejecución continua.
- Acceso web funcional.
- Creación y persistencia del usuario administrador.
- Indexación correcta de bibliotecas grandes.
- Servicio OPDS accesible y operativo.
- Importación automática al añadir archivos a BookDrop.
- Ausencia de errores críticos en logs durante escaneos largos.
Decisiones importantes o problemas detectados
- El primer escaneo de bibliotecas grandes puede ser costoso en CPU y disco.
- La calidad del metadata depende mucho del nombrado inicial de los archivos.
- Cambios frecuentes en la estructura de carpetas provocan reindexados innecesarios.
- El servicio funciona mejor cuando la biblioteca se mantiene estable y bien organizada.
Resumen breve
- BookLore funciona como alternativa moderna a Calibre o junto a el.
- Maneja bibliotecas grandes sin problemas apreciables.
- OPDS integrado y usable.
- Compatible con bibliotecas compartidas junto a Calibre (por lo que ahora llevo testeado, no puedo afirmarlo al 100%).
- Instalación sencilla, limpia y mantenible.
Archivos de configuración
Los archivos se mantienen en Gitea: