Kavita — Biblioteca de ebooks y cómics¶

Sustituiría a Kindle y Google Play Libros. Lector integrado en navegador para ebooks (EPUB, PDF) y cómics (CBZ, CBR), con progreso sincronizado entre dispositivos.

Como usuario¶

Qué podrás hacer¶

Leer ebooks (EPUB, PDF) y cómics (CBZ, CBR)
Lector integrado en navegador
Apps OPDS en móvil para lectura offline
Progreso sincronizado entre dispositivos

Cómo se accederá¶

Plataforma	Cómo
Navegador	https://libros.sc
Ubuntu	Navegador
Android	Moon+ Reader / Librera Reader vía OPDS
FireTV	No aplica

Primeros pasos (previstos)¶

En Android: abre tu app de lectura (Moon+ Reader o Librera Reader), ve a "añadir servidor OPDS" e introduce: URL https://libros.sc/api/opds, usuario y contraseña SmallCountry.

Integración con otros servicios de SmallCountry¶

Servicio	Relación
Readarr	Adquisición de libros
n8n	Ciclo de vida
Audiobookshelf	Separación: Kavita para lectura visual, Audiobookshelf para audio
Nextcloud	Carpeta Libros/inbox donde subir archivos

Servicios que lo hacen posible¶

ZFS — almacenamiento persistente
Authentik — autenticación
Caddy — proxy reverso

Para el administrador (diseño previsto)

Datos del servicio¶


LXC (contenedor ligero de Proxmox)	174
IP	10.10.20.174
Tier	C
Impacto	🟢 Bajo

Docker: kavita.

Almacenamiento persistente¶

ZFS (sistema de archivos con integridad de datos): rpool/datos/kavita → /opt/kavita/ Biblioteca: SATA /libros/. Backup: PBS (sistema de copias de seguridad de Proxmox) diario.

Healthcheck¶

curl https://libros.sc

Logs y diagnóstico¶

docker logs --tail 100 kavita

Backup manual¶

zfs snapshot rpool/datos/kavita@manual-$(date +%Y%m%d)

Problemas comunes¶

No detecta archivos nuevos → Ejecutar escaneo manual desde la interfaz de Kavita.
OPDS no funciona → Verificar que la URL es exactamente https://libros.sc/api/opds.

Para el arquitecto (diseño previsto)

Relaciones con otros servicios¶

flowchart LR
    Caddy -->|TLS| Kavita
    Authentik -->|Proxy| Kavita
    Readarr -->|Adquisición| Kavita
    Nextcloud -->|Inbox| Kavita

Configuración de red¶

Bridge	Puerto	Acceso desde
vmbr2	5000	Caddy (LXC 102)

En Pi-hole¶

libros.sc  →  10.10.20.174

En Caddy¶

libros.sc {
    forward_auth authentik.sc
    reverse_proxy 10.10.20.174:5000
}

En Authentik¶

Provider: Proxy. Grupo: familia.

Orquestación¶

Componente	Path
Rol Ansible	`roles/kavita/`
Playbook	`deploy-kavita.yml`
Módulo OpenTofu	`modules/kavita/`

Secciones relacionadas¶

🌐 Enlaces de interés¶

Kavita · Documentación · GitHub