Cómo instalar Kavita en Docker - Servidor de lectura autohospedado

Kavita | Reading Server | Docker | Self-Hosted | Manga/Comics/Books

Kavita en Docker: Servidor de lectura autohospedado para Manga, Webtoons, Comics y Libros. Multi-usuario, lectores responsivos, metadatos, biblioteca compartida (alternativa Ubooquity, Komga) 📚📖

Kavita es un servidor de lectura completo autohospedado para manga, webtoons, cómics (CBR, CBZ, ZIP, RAR, 7Z) y libros (EPUB, PDF). Lectores responsivos web. Gestión usuarios. Integración metadatos. Anotaciones EPUB. Filtros inteligentes. Compartir librería multi-dispositivo. Community Edition gratuita. Production-ready Docker.

¿Qué es Kavita en Docker?


Kavita es un servidor de lectura rápido y completo autohospedado que permite servir manga, webtoons, cómics y libros con una interfaz web responsiva, soporte multi-usuario, integración de metadatos, anotaciones, y todo bajo tu control sin dependencias de servicios terceros. Ideal para lectores apasionados, coleccionistas y homelabs.

Propuesta clave: Reading server enterprise-grade self-hosted. Soporta manga (CBR, CBZ, ZIP, RAR, 7Z), webtoons, cómics y libros (EPUB, PDF). Lectores web responsivos (mobile, tablet, desktop). Modo lectura continua (webtoon). Modo libro virtual (EPUB). Multi-usuario con control roles (admin, member). Metadatos integrados (cover, descripción, géneros, calificaciones). Integración externa (Kavita+). Anotaciones y highlights EPUB. Filtros inteligentes. Collections, listas lectura, want-to-read. Descarga metadatos, reseñas, calificaciones. Tematización customizable. Localización completa (Weblate). API REST. OPDS feed. Zero cloud, 100% privacidad. GPL-3.0 open source. Production-ready.

Para lectores y coleccionistas: Servidor lectura profesional. Multi-dispositivo. Biblioteca compartida. Control total privacidad. Zero suscripción.

Características principales

Formatos múltiples

Manga: CBR, CBZ, ZIP, RAR, RAR5, 7Z. Webtoons. Cómics. Libros: EPUB, PDF. Raw images.

Lectores responsivos

Web reader completo. Modo webtoon (scroll continuo). Modo libro virtual (EPUB). Funciona perfecto en móvil, tablet, desktop.

Multi-usuario seguro

Gestión usuarios, roles (admin, member). Control acceso. Restricciones edad. OIDC (OAuth).

Metadatos integrados

Covers, descripciones, géneros, autores, calificaciones. Búsqueda y filtros avanzados.

Biblioteca compartida

Collections, listas lectura, want-to-read. Compartir con amigos/familia.

Anotaciones EPUB

Highlights, notas, bookmarks en EPUB. Annotations integradas.

Dashboard customizable

Filtros inteligentes. Orden personalizado. Visibilidad toggles.

Localización completa

Multi-idioma (Weblate). Temas customizables. API REST.

Requisitos del sistema

  • Docker & Docker Compose v2+
  • 2 GB - 4 GB RAM mínimo (Kavita es ligero)
  • 50 GB - 500+ GB espacio disco (según librería manga/cómics/libros)
  • /mnt/media/kavita directorio accesible (o configurar ruta)
  • Puerto TCP disponible: 5000 (configurable)
  • CPU: 1-2+ cores (muy ligero)
  • Acceso internet (opcional: para metadatos, OPDS feeds)
Muy ligero: Kavita consume pocos recursos. Perfecto para Raspberry Pi, NAS, homelab limitado. SQLite integrado.

Estructura directorios /mnt/media

Kavita necesita carpetas para config y librería de lectura:

/mnt/media/kavita/ ├── config/ # Configuración Kavita ├── data/ # Base datos SQLite └── library/ # Manga, cómics, libros (tus archivos) ├── manga/ ├── comics/ └── books/

Instalación con Docker Compose

Paso 1: Preparar estructura directorios

# Crear carpetas Kavita sudo mkdir -p /mnt/media/kavita/{config,data,library} # Permisos sudo chown -R 1000:1000 /mnt/media/kavita sudo chmod -R 755 /mnt/media/kavita

Paso 2: Crear docker-compose.yml

mkdir -p ~/kavita && cd ~/kavita cat > docker-compose.yml << 'DOCKER' version: '3.8' services: kavita: image: jvmilazz0/kavita:latest container_name: kavita restart: unless-stopped ports: - "5000:5000" environment: - PUID=1000 - PGID=1000 - TZ=Europe/Madrid # Opcionales: # - KAVITA_PORT=5000 # - KAVITA_API_KEY=tuAPIKeySegura volumes: - /mnt/media/kavita/config:/config - /mnt/media/kavita/library:/library DOCKER

Paso 3: Iniciar Kavita

docker compose up -d # Espera ~10 segundos para que inicie docker compose ps # Debería mostrar kavita en estado "Up"

Acceder a Kavita

📚 Kavita Web UI: http://localhost:5000

💡 Desde otros dispositivos: Usa la IP de tu servidor:
http://192.168.1.100:5000 (reemplaza con tu IP)
Para obtener tu IP: hostname -I

Primeros pasos

1. Setup inicial (username y contraseña)

  1. Abre http://localhost:5000
  2. Setup wizard aparece automático
  3. Configura:
    • Admin username (ej: admin)
    • Admin password (segura!)
    • Directorio librería (ej: /library)
  4. Click "Confirm" → Kavita inicia library scan

2. Agregar contenido a la librería

  1. Copia tus archivos manga/cómics/libros a /mnt/media/kavita/library/
  2. Formatos soportados:
    • Manga/Cómics: CBR, CBZ, ZIP, RAR, RAR5, 7Z
    • Webtoons: archivos imagen en carpeta
    • Libros: EPUB, PDF
  3. Estructura recomendada:
    /mnt/media/kavita/library/ ├── Manga/ │ ├── [Manga Título]/ │ │ ├── [Volumen 1]/ │ │ │ ├── image1.jpg │ │ │ ├── image2.jpg │ │ │ └── ... │ │ └── [Volumen 2]/ ├── Comics/ │ └── [Comic Nombre].cbz └── Books/ └── [Libro Nombre].epub
  4. Ve a Settings → Library → Scan now
  5. Kavita detecta e indexa automático

3. Explorar y leer

  1. Dashboard muestra series detectadas
  2. Click en serie → ver volúmenes
  3. Click en volumen → abre reader
  4. Reader soporta:
    • Modo página (manga/cómics)
    • Modo webtoon (scroll continuo)
    • Modo libro (EPUB virtual pages)

4. Crear usuarios

  1. Settings → Users → New user
  2. Fill: username, email, password, rol
  3. Roles: Admin, Member
  4. Click "Add user" → usuario puede login

5. Crear collections y listas lectura

  1. Collections: agrupa series por tema (ej: "Favoritos")
  2. Reading Lists: secuencia lectura personalizada
  3. Want to Read: guardados para leer después
  4. Comparte colecciones con otros usuarios

6. Configurar metadatos

  1. Settings → Libraries
  2. Kavita auto-detecta covers, descripciones, géneros
  3. Opción: integración Kavita+ (descarga metadatos externos)

7. Usar OPDS feed

# OPDS feed URL para apps OPDS compatibles: http://localhost:5000/api/opds # Compatible: Moon+ Reader, Elytra, Page Turner, etc

Casos de uso

  • Lectores manga/cómics: Librería personal. Multi-dispositivo. Lector web profesional.
  • Coleccionistas: Organiza manga, webtoons, cómics en servidor propio. Metadatos automáticos.
  • Familia/amigos: Comparte librería lectura con multi-usuario. Biblioteca compartida segura.
  • Homelabs: Ultra-ligero. Perfecto Raspberry Pi, NAS, VPS pequeño.
  • Privacidad: Self-hosted. Sin cloud. Sin tracking. Control total datos lectura.

Gestión y mantenimiento

Ver estado

docker compose ps

Ver logs

docker compose logs -f kavita

Detener Kavita

docker compose down # Datos persisten en /mnt/media/kavita

Actualizar a versión nueva

docker compose pull docker compose up -d

Re-scan librería

# Desde UI: Settings → Library → Scan Now # O desde API: curl -X POST http://localhost:5000/api/library/scan -H "Authorization: Bearer YOUR_API_KEY"

Backup datos

tar -czf kavita-backup-$(date +%Y%m%d).tar.gz /mnt/media/kavita

Restore desde backup

docker compose down tar -xzf kavita-backup-20240815.tar.gz -C / docker compose up -d

Formatos soportados

Manga y Cómics

  • CBR - Comic Book RAR
  • CBZ - Comic Book ZIP
  • ZIP - Archivos image ZIP
  • RAR/RAR5 - Archivos image RAR
  • 7Z - Archivos image 7zip
  • Raw images - JPG, PNG, etc en carpeta

Libros

  • EPUB - Electronic Publication (con annotations)
  • PDF - Portable Document Format

Formatos imagen soportados

  • JPG, PNG, GIF, WebP, BMP, TIFF

Comparativa con alternativas

vs Ubooquity

Kavita gana: Interface moderna, metadatos integrados, multi-usuario avanzado, lectores responsivos, anotaciones EPUB. Ubooquity gana: Más ligero (Java), interface clásica.

vs Komga

Kavita gana: Libros EPUB nativos, anotaciones. Komga gana: Enfoque específico cómics, quizás más optimizado.

vs Tachiyomi / Manga Reader Apps

Kavita gana: Server self-hosted, compartir librería multi-usuario. Apps ganan: Mobile-first, tracking externo, fuentes online.

Mejor para: Servidor lectura self-hosted. Multi-dispositivo. Multi-usuario. Librería completa (manga/cómics/libros). Homelabs.

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

Telegram Discord YouTube GitHub Blog Twitter

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

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

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=...
Read more »