Cómo instalar y configurar Calibre en Docker. Calibre: Tu biblioteca digital autohospeada

-
 Calibre  |  Docker  |  LinuxServer

Calibre en Docker: Tu Biblioteca Digital Completa

Gestiona, organiza y lee tus libros electrónicos desde cualquier dispositivo con Calibre en Docker.

 ¿Qué es Calibre?


Calibre es el gestor de libros electrónicos de código abierto más potente y completo que existe. Permite organizar bibliotecas digitales masivas, convertir entre formatos, editar metadatos, sincronizar con e-readers, y mucho más. Es utilizado por millones de usuarios desde aficionados hasta bibliotecas profesionales.

La imagen Docker de LinuxServer.io empaqueta Calibre con una interfaz web completa basada en Selkies, lo que te permite acceder a toda la aplicación desde el navegador sin necesidad de instalar nada en tu equipo. Además, incluye el servidor web integrado de Calibre para compartir tu biblioteca en la red.

Ventaja clave: Accede a tu biblioteca de libros desde cualquier dispositivo (PC, tablet, móvil) a través del navegador. Tus datos están centralizados y protegidos en tu servidor.

⚡ Características principales

 Gestión completa

Organiza miles de libros con metadatos, portadas, etiquetas y colecciones personalizadas.

 Conversión de formatos

Convierte entre EPUB, MOBI, AZW3, PDF y más de 20 formatos diferentes.

 Servidor web integrado

Comparte tu biblioteca en la red local y descarga libros desde cualquier dispositivo.

 Sincronización con e-readers

Compatible con Kindle, Kobo, Nook y otros lectores electrónicos.

✍️ Editor de metadatos

Edita títulos, autores, series, portadas y descripciones masivamente.

 Interfaz web completa

Accede a la GUI completa de Calibre desde el navegador sin instalar nada.

 Instalación con Docker Compose

Paso 1: Crear el directorio del proyecto

mkdir ~/calibre cd ~/calibre nano docker-compose.yml

Paso 2: Configurar docker-compose.yml

Pega el siguiente contenido:

version: '3.8' services: calibre: image: lscr.io/linuxserver/calibre:latest container_name: calibre security_opt: - seccomp:unconfined # Necesario para la GUI environment: - PUID=1000 - PGID=1000 - TZ=Europe/Madrid - PASSWORD= # Opcional: contraseña para la GUI web volumes: - ./config:/config - ./libros:/config/Calibre Library # Ruta OBLIGATORIA ports: - 8080:8080 # GUI web HTTP (solo proxy inverso) - 8181:8181 # GUI web HTTPS (acceso directo) - 8081:8081 # Servidor web de Calibre shm_size: "1gb" restart: unless-stopped
⚠️ Importante: La ruta de la biblioteca DEBE ser /config/Calibre Library dentro del contenedor. No uses otra ruta o la configuración no funcionará correctamente.

Paso 3: Ajustar permisos de usuario

Verifica tu UID y GID en el sistema:

id tu_usuario

Actualiza los valores de PUID y PGID en el compose si son diferentes de 1000.

Paso 4: Iniciar el contenedor

docker compose up -d

El primer inicio puede tardar unos minutos mientras se descargan las capas de la imagen y se configura el entorno.

Paso 5: Verificar el estado

# Ver logs en tiempo real docker compose logs -f calibre # Comprobar que está ejecutándose docker compose ps

 Acceder a Calibre

Puertos disponibles

PuertoFunciónAcceso
8181 GUI completa de Calibre (HTTPS) https://tu-ip:8181
8080 GUI completa de Calibre (HTTP) Solo para proxy inverso
8081 Servidor web de Calibre http://tu-ip:8081
Recomendación: Para acceso directo, usa el puerto 8181 con HTTPS. El puerto 8080 está pensado para uso detrás de un proxy inverso como Nginx o Traefik.

Configuración inicial del asistente

Al acceder por primera vez, Calibre mostrará un asistente de configuración:

  • Ubicación de la biblioteca: Deja la ruta por defecto /config/Calibre Library
  • Idioma: Selecciona tu idioma preferido
  • Dispositivo: Configura tu e-reader si lo tienes conectado (opcional)

 Habilitar el servidor web de Calibre

El servidor web de Calibre no está habilitado por defecto. Para activarlo:

  1. Accede a la GUI de Calibre en el puerto 8181
  2. Ve a Preferencias → Compartir en red
  3. Marca la casilla "Iniciar servidor automáticamente"
  4. Asegúrate de que el puerto está configurado en 8081
  5. Guarda los cambios

Ahora podrás acceder a tu biblioteca desde otros dispositivos en http://tu-ip:8081

⚙️ Variables de entorno opcionales

Protección con contraseña

environment: - PASSWORD=mi-password-segura

Establece autenticación HTTP básica para la GUI web. Usuario por defecto: abc

Argumentos CLI adicionales

environment: - CLI_ARGS=--with-library=/config/Calibre Library

Permite pasar argumentos adicionales al inicio de Calibre.

Zona horaria

environment: - TZ=Europe/Madrid

Configura la zona horaria del contenedor. Lista completa aquí.

 Gestión del contenedor

Ver logs en tiempo real

docker compose logs -f calibre

Reiniciar el contenedor

docker compose restart calibre

Detener y eliminar

# Detener el contenedor docker compose down # Detener y eliminar volúmenes (BORRA TODOS LOS DATOS) docker compose down -v

Actualizar a la última versión

# Descargar la imagen actualizada docker compose pull # Recrear el contenedor con la nueva versión docker compose up -d # Limpiar imágenes antiguas docker image prune

 Copias de seguridad

Tus datos están en dos carpetas principales:

  • ./config - Configuración de Calibre, metadatos y base de datos
  • ./libros - Archivos de los libros electrónicos

Backup manual

# Detener Calibre antes del backup docker compose down # Crear backup comprimido con fecha tar -czf calibre-backup-$(date +%Y%m%d).tar.gz ./config ./libros # Reiniciar Calibre docker compose up -d

Restaurar desde backup

# Detener el contenedor docker compose down # Extraer el backup tar -xzf calibre-backup-20260419.tar.gz # Reiniciar docker compose up -d

 Consideraciones de seguridad

⚠️ Importante: Esta imagen proporciona acceso privilegiado al sistema. NO la expongas directamente a Internet sin protección adecuada.
  • HTTPS es obligatorio: El puerto 8181 usa un certificado autofirmado. Para producción, usa un proxy inverso con certificado válido.
  • Autenticación básica: La variable PASSWORD solo es adecuada para redes locales confiables.
  • Para acceso desde Internet: Usa un proxy inverso como SWAG con autenticación robusta.
  • Terminal integrada: La GUI web incluye un terminal con acceso root. Cualquier usuario con acceso puede ejecutar comandos en el contenedor.

 Solución de problemas

El contenedor no arranca

# Revisar logs completos docker compose logs calibre # Verificar permisos de las carpetas ls -la ./config ./libros

Error de permisos

# Ajustar propietario de las carpetas (reemplaza 1000 con tu UID/GID) sudo chown -R 1000:1000 ./config ./libros

La GUI no carga o está lenta

  • Aumenta shm_size a "2gb" o más en el compose
  • Verifica que tu servidor tenga suficiente RAM disponible
  • Comprueba que security_opt: seccomp:unconfined esté presente

El servidor web (puerto 8081) no funciona

Recuerda que debes habilitarlo manualmente desde Preferencias → Compartir en red dentro de la GUI de Calibre.

 Referencias Oficiales

 Apoya el canal GENBYTE

▶ Suscríbete al canal de YouTube Suscríbete a la newsletter semanal ☕ Invítame a un Ko-fi ✉ genbyte@proton.me

 Sígueme en mis redes sociales

Comentarios

Publicar un comentario

Entradas populares de este blog

Cómo Instalar y configurar SERVIDOR VPN WIREGUARD en MIKROTIK 🔐 #VPN #Wireguard #Mikrotik #RouterOS

-
Imagen
Wireguard en Mikrotik Breve Explicación de Wireguard ¿Qué es WireGuard VPN? WireGuard es un nuevo protocolo de VPN. No se trata de un software, sino de un conjunto de instrucciones que permite crear VPNs de forma muy sencilla. Ha sido desarrollada como una alternativa a IPsec, OpenVPN y similares VPNs, pero más rápida y sencilla de usar. En esencia, WireGuard está basado en ideas del protocolo IPsec. WireGuard es una VPN extremadamente simple, pero rápida y moderna que utiliza criptografía de última generación. Su objetivo es ser más rápido, más simple, y más versátil que IPSec, evitando al mismo tiempo el enorme dolor de cabeza (sobre todo en redes con NAT). Pretende ser considerablemente más eficaz que OpenVPN. WireGuard está diseñado como una VPN de propósito general para ejecutarse en interfaces embebidas, apto para muchas circunstancias diferentes. Se ejecuta sobre el protocolo UDP, por lo tanto es considerado un túnel de capa 3. ¿Cómo funciona Wireguard VPN? WireGuard es un proto...
Leer más

Cómo instalar y configurar DSM SYNOLOGY 7.2.2 en PC | Guía completa, instalación, RAID 1, SMB

-
Imagen
Instalación y puesta en marcha de Synology DSM 7.2.2 en PC Vídeo ACTUALIZADO, NUEVA VERSIÓN DEL ARC LOADER:  https://youtu.be/LgghogL-UCA https://genbyte.blogspot.com/2025/08/como-convertir-pc-en-synlogy-con-6-tb.html ----- Proceso de instalación y puesta en marcha de sistema operativo DSM Synology versión 7.2.2 en un PC, concretamente un HP 800 G1 EliteDesk. El PC tendrá 3 discos SSD, uno de 120 GB para el S.O. DSM, y otros dos de 240GB cada en RAID 1 para los Datos. Los 3 dicos duros conectados al PC mediante cables SATA. Lo primero que necesitamos es descargar la imagen bootloader ARC, desde el siguiente repositorio de Gothub, también necesitamos Rufus, en este momento, es la versión 4.6. Imagen ARC:  https://github.com/AuxXxilium/arc Imagen usado en el vídeo 1.1.29:  https://github.com/AuxXxilium/arc/releases/tag/1.1.29 Rufus:  https://rufus.ie/es/ Después de descargar la imagen ARC.img, conectamos nuestro primer disco SSD de 120GB por cable o conector SATA-USB y...
Leer más

Cómo INSTALAR y CONFIGURAR OpenVPN en MIKROTIK. Guía completa paso a paso.

-
Imagen
Cómo INSTALAR y CONFIGURAR OpenVPN en MIKROTIK. Guía completa paso a paso. Vídeo tutorial paso a paso en Youtube Desarrollo Ilustración: Diagrama RED Creación de Redes (Address) ----------------------------------------------- WAN 192.168.1.0/24 LAN 192.168.88.0/24 VPN 192.168.100.0/24 Creación del Rango VPN ------------------------ 192.168.100.1 - 192.168.100.100 Creación de los Certificados ------------------------------- Los certificados que vamos a crear a continuación tendrán una validez de 10 años; days-valid=3650 Crear certificado CA ---------------------- /certificate add name=CA-tpl country="" state="" locality="" organization="" unit="" common-name="CA" key-size=4096 days-valid=3650 key-usage=crl-sign,key-cert-sign /certificate sign CA-tpl ca-crl-host=127.0.0.1 name="CA" Crear certificado Server -------------------------- /certificate add name=SERVER-tpl country="" state="" locality=...
Leer más