Por Mid 
¿Buscas una forma moderna y eficiente de gestionar tu biblioteca digital? BookLore Docker Compose es la solución perfecta para crear tu propia biblioteca de libros electrónicos auto-hospedada. En esta guía completa descubrirás cómo desplegar BookLore Docker Compose en minutos, una plataforma multiusuario con soporte para EPUB, PDF y cómics que incluye sincronización con Kobo, gestión inteligente de metadatos y un lector integrado.
¿Qué es BookLore Docker Compose?
BookLore Docker Compose es una aplicación web de código abierto diseñada para gestionar bibliotecas digitales de forma privada y eficiente. A diferencia de soluciones anticuadas como Calibre, esta herramienta ofrece una interfaz moderna y responsive que funciona perfectamente en cualquier dispositivo.
Con más de 7.300 estrellas en GitHub, esta plataforma desarrollada con tecnologías modernas se ha convertido en una de las alternativas más populares para quienes buscan controlar sus libros electrónicos sin depender de servicios en la nube, similar a cómo Docker Hub facilita el despliegue de aplicaciones.
Características principales de BookLore Docker Compose
- Gestión multiusuario: Crea cuentas para tu familia con permisos granulares
- Estanterías inteligentes: Organización automática basada en reglas y filtros dinámicos
- Metadatos automáticos: Búsqueda y descarga de portadas, autores y descripciones desde múltiples fuentes
- Sincronización con Kobo: Conecta tu e-reader y sincroniza progreso de lectura
- Soporte KOReader: Seguimiento multiplataforma del progreso de lectura
- Protocolo OPDS: Compatible con aplicaciones de lectura de terceros
- BookDrop: Importación automática de libros arrastrando archivos a una carpeta
- Lector integrado: Lee EPUB, PDF y cómics directamente desde el navegador
- Anotaciones privadas: Guarda notas y destacados personales
- Reseñas comunitarias: Comparte opiniones con otros usuarios de tu instancia
Requisitos previos para instalar BookLore Docker Compose
Antes de comenzar con la instalación, asegúrate de cumplir con estos requisitos mínimos:
- Docker Engine: Versión 20.10 o superior instalada (guía oficial de instalación)
- Docker Compose: Versión 2.0 o superior
- RAM: Mínimo 2GB disponibles para los contenedores
- Almacenamiento: Al menos 10GB libres para la base de datos y libros
- Puerto: Puerto 6060 disponible (configurable)
- Conexión a internet: Para descargar metadatos y portadas automáticamente
Instalación de BookLore con Docker Compose paso a paso
Paso 1: Crear la estructura de directorios
Primero, crea los directorios necesarios para tu instalación de BookLore Docker Compose:
mkdir -p ~/booklore/{config/mariadb,data,books,bookdrop}
cd ~/bookloreEsta estructura organizada facilita las copias de seguridad y el mantenimiento del sistema.
Paso 2: Configurar las variables de entorno
Crea un archivo .env con las credenciales y configuración de tu instalación:
nano .envAñade el siguiente contenido, modificando las contraseñas por unas seguras:
# Configuración de la aplicación
APP_USER_ID=1000
APP_GROUP_ID=1000
TZ=Europe/Madrid
BOOKLORE_PORT=6060
# Conexión a la base de datos
DATABASE_URL=jdbc:mariadb://mariadb:3306/booklore
DB_USER=booklore
DB_PASSWORD=TuContraseñaSegura2025!
# Configuración de MariaDB
MYSQL_ROOT_PASSWORD=ContraseñaRootSegura2025!
MYSQL_DATABASE=bookloreImportante: Cambia APP_USER_ID y APP_GROUP_ID por los valores de tu usuario. Puedes obtenerlos ejecutando id en la terminal.
Paso 3: Crear el archivo docker-compose.yml
Ahora crea el archivo de configuración principal de BookLore Docker Compose:
nano docker-compose.ymlCopia esta configuración completa y funcional:
version: '3.8'
services:
booklore:
image: ghcr.io/booklore-app/booklore:latest
container_name: booklore
restart: unless-stopped
ports:
- "${BOOKLORE_PORT}:6060"
environment:
- DATABASE_URL=${DATABASE_URL}
- TZ=${TZ}
- PUID=${APP_USER_ID}
- PGID=${APP_GROUP_ID}
volumes:
- ./data:/app/data
- ./books:/books
- ./bookdrop:/bookdrop
depends_on:
mariadb:
condition: service_healthy
networks:
- booklore-network
mariadb:
image: mariadb:11.4.5
container_name: booklore-db
restart: unless-stopped
environment:
- MYSQL_ROOT_PASSWORD=${MYSQL_ROOT_PASSWORD}
- MYSQL_DATABASE=${MYSQL_DATABASE}
- MYSQL_USER=${DB_USER}
- MYSQL_PASSWORD=${DB_PASSWORD}
volumes:
- ./config/mariadb:/var/lib/mysql
healthcheck:
test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
interval: 10s
timeout: 5s
retries: 5
start_period: 30s
networks:
- booklore-network
networks:
booklore-network:
driver: bridgePaso 4: Iniciar los contenedores
Ejecuta el siguiente comando para descargar las imágenes e iniciar los servicios:
docker compose up -dVerifica que los contenedores estén funcionando correctamente:
docker compose psDeberías ver ambos servicios con el estado «Up» y «healthy» en el caso de MariaDB.
Paso 5: Acceder a la interfaz web
Abre tu navegador y accede a:
http://localhost:6060O utiliza la IP de tu servidor seguida del puerto 6060. La primera vez que accedas, el servicio te pedirá crear una cuenta de administrador.
Configuración inicial de BookLore Docker Compose
Una vez dentro de BookLore Docker Compose, sigue estos pasos para completar la configuración:
- Crea tu cuenta de administrador: Introduce nombre de usuario, email y contraseña
- Configura las estanterías: Define categorías personalizadas para organizar tus libros
- Activa BookDrop: Habilita la importación automática desde la carpeta
bookdrop - Configura metadatos: Selecciona las fuentes preferidas para obtener información automática
- Añade usuarios: Si vas a compartir la biblioteca, crea cuentas con permisos específicos
BookLore Docker Compose: Uso de BookDrop para importar libros
Una de las funcionalidades más prácticas de esta plataforma es BookDrop, que permite añadir libros simplemente copiando archivos a una carpeta:
cp /ruta/a/tus/libros/*.epub ~/booklore/bookdrop/El sistema detectará automáticamente los archivos, extraerá metadatos, descargará portadas y los preparará para que los revises antes de añadirlos a la biblioteca. Este proceso funciona con formatos EPUB, PDF, MOBI, CBZ, CBR y más.
Sincronización Kobo en BookLore Docker Compose
BookLore incluye soporte nativo para e-readers Kobo, permitiéndote sincronizar tu progreso de lectura:
- En la configuración de BookLore, activa la integración Kobo
- Conecta tu Kobo por USB a tu ordenador
- Accede a la configuración del dispositivo Kobo
- Añade la URL del servidor BookLore como tienda personalizada
- Sincroniza tu biblioteca y comienza a leer
El progreso de lectura se actualizará automáticamente entre el dispositivo y el servidor. Para más detalles, consulta la documentación oficial de Kobo sync.
Protocolo OPDS en BookLore Docker Compose
El soporte OPDS (Open Publication Distribution System) de BookLore Docker Compose permite conectar aplicaciones de lectura de terceros a tu biblioteca:
http://tu-servidor:6060/opdsAplicaciones compatibles incluyen Marvin (iOS), KOReader (multiplataforma) y Moon+ Reader (Android). Simplemente añade esta URL como catálogo OPDS en tu aplicación favorita según la especificación OPDS.
Mantenimiento de BookLore Docker Compose
Para mantener tu instalación de BookLore Docker Compose segura y actualizada, sigue estas recomendaciones:
Realizar copias de seguridad
Respalda regularmente estos directorios:
tar -czf booklore-backup-$(date +%Y%m%d).tar.gz ~/booklore/Esto creará un archivo comprimido con toda tu configuración, base de datos y libros.
Actualizar a la última versión
Para actualizar BookLore Docker Compose a la versión más reciente:
cd ~/booklore
docker compose pull
docker compose up -dDocker Compose descargará automáticamente las nuevas imágenes y recreará los contenedores manteniendo tus datos intactos.
Monitorizar logs
Si experimentas problemas, revisa los logs:
docker compose logs -f bookloreBookLore Docker Compose con proxy inverso
Para acceder a tu instalación de BookLore Docker Compose desde internet con un dominio personalizado y HTTPS, puedes usar Caddy o Nginx Proxy Manager. Aquí tienes un ejemplo básico con Caddy:
books.tudominio.com {
reverse_proxy booklore:6060
}Esta configuración proporcionará certificados SSL automáticos mediante Let’s Encrypt, garantizando conexiones seguras.
Solución de problemas en BookLore Docker Compose
Los contenedores no inician
Verifica que el puerto 6060 no esté ocupado:
sudo netstat -tulpn | grep 6060Si está ocupado, cambia el puerto en el archivo .env.
Problemas con permisos de archivos
Asegúrate de que los valores de APP_USER_ID y APP_GROUP_ID coincidan con tu usuario:
id
sudo chown -R $USER:$USER ~/booklore/La base de datos no se conecta
Verifica que MariaDB esté saludable:
docker compose ps mariadbSi muestra «unhealthy», revisa los logs de MariaDB para identificar el error.
Preguntas frecuentes sobre BookLore Docker Compose
¿BookLore es compatible con Calibre?
Sí, puedes importar tu biblioteca de Calibre existente copiando los archivos a la carpeta bookdrop. Los metadatos se reindexarán automáticamente.
¿Puedo usar BookLore en una Raspberry Pi?
Sí, funciona perfectamente en Raspberry Pi 4 con al menos 2GB de RAM. Asegúrate de usar la imagen ARM64 apropiada disponible en GitHub Container Registry.
¿Cómo añado más usuarios a mi biblioteca?
Desde el panel de administración, accede a «Usuarios» y crea nuevas cuentas. Puedes establecer permisos granulares para cada usuario.
¿Qué formatos de libros soporta?
La aplicación es compatible con EPUB, PDF, MOBI, AZW3, CBZ, CBR y otros formatos populares de libros electrónicos y cómics.
¿BookLore consume muchos recursos?
No, es bastante ligero. Con 2GB de RAM y un procesador modesto es suficiente para bibliotecas de miles de libros.
Conclusión
BookLore Docker Compose representa la evolución moderna de las bibliotecas digitales auto-hospedadas. Con su interfaz intuitiva, sincronización con dispositivos Kobo, importación automática mediante BookDrop y soporte para múltiples usuarios, se posiciona como la mejor alternativa a servicios comerciales de libros electrónicos.
El despliegue de BookLore Docker Compose simplifica la instalación y mantenimiento, permitiéndote tener tu biblioteca funcionando en menos de 10 minutos. Ya sea que gestiones cientos o miles de libros, esta solución escalable y eficiente te dará el control total sobre tu colección literaria digital.
Si buscas más herramientas para tu homelab, no te pierdas nuestra categoría completa de tutoriales Docker Compose donde encontrarás guías para Nextcloud, Jellyfin, Portainer y muchas más aplicaciones auto-hospedadas.