Cómo instalar Audiobookshelf en Docker - Servidor audiobooks y podcasts autohospedado

Audiobookshelf | Audiobooks | Podcasts | Docker | Self-Hosted | Progressive Web App | iOS/Android | Chromecast | 14.1k stars

Audiobookshelf en Docker: Servidor audiobooks y podcasts autohospedado open source con streaming any format, podcast auto-download, multi-usuario, progress sync cross-device, chapter editor, m4b merge, metadata autocomplete, Chromecast, Progressive Web App, iOS/Android apps beta, RSS feeds, ebook support, 14.1k stars, GPL-3.0, production-ready 🎧📚

Audiobookshelf es un servidor audiobook y podcast autohospedado completamente open source. Streaming de todos los formatos audio (MP3, M4A, FLAC, etc) on-the-fly. Descarga automática podcasts. Multi-usuario con progreso sincronizado entre dispositivos. Editor capítulos. Merge audiobooks a m4b. Metadata autocomplete. Soporte Chromecast. Progressive Web App. Apps iOS/Android (beta). RSS feeds. Basic ebook support. 14.1k GitHub stars. GPL-3.0 open source. NodeJs + FFmpeg. Production-ready Docker.

¿Qué es Audiobookshelf en Docker?

Audiobookshelf es un servidor audiobook y podcast completamente autohospedado y open source que proporciona streaming de cualquier formato audio on-the-fly, descarga automática de episodios podcasts, sincronización de progreso multi-usuario entre dispositivos, editor de capítulos, merge de archivos audio a m4b, metadata autocomplete, soporte Chromecast, Progressive Web App, apps iOS/Android nativas, feeds RSS, soporte ebook, todo bajo tu control sin Audible/Spotify lock-in. La plataforma audiobook y podcast que pedías para autohospedado.

Propuesta clave: Self-hosted audiobook + podcast server. Stream any audio format (MP3, M4A, FLAC, WAV, OGG, Opus, AAC on-the-fly). Podcast search, subscribe, auto-download episodes, manage playback. Multi-user support (accounts separadas, permissions). Progress per user, sync across devices (web, mobile, desktop). Auto-detect library updates (no manual re-scan needed). Upload books + podcasts (bulk drag-drop, auto-organize). Backup metadata + daily backups automated. Progressive Web App (PWA) - works offline. Chromecast support (web + Android apps). Chapter editor + Audnexus API integration (auto-lookup chapters). Merge multiple audio files → single m4b. Embed metadata + cover art into files. Ebook support (Epub, PDF, CBR, CBZ, Kindle send). Open RSS feeds (podcasts + audiobooks). Audio metadata fetch (multiple sources: Audible, Libby, Overdrive, Google Books). Custom library organization (series, authors, narrators, genres). 14.1k GitHub stars. 6.5k commits. Active development (frontend rewrite to React in progress). GPL-3.0 open source. NodeJs backend + Vue.js frontend (React coming). FFmpeg para encoding audio. Docker ready + Unraid template.

Para audiophiles + podcast lovers: Audiobooks sin DRM. Podcasts autohospedado. Sync multi-device. Open source. Privacy first.

Características principales

Stream any audio format

MP3, M4A, FLAC, WAV, OGG, Opus, AAC. On-the-fly transcoding optional.

Podcast management

Search, subscribe, auto-download episodes, manage backlog. Feed RSS.

Multi-usuario

Cuentas separadas. Permissions personalizadas. Roles different.

Progress sync

Continúa donde dejaste (web, mobile, desktop). Sync automático.

Chapter editor

Edit, create, auto-lookup chapters (Audnexus API). Customizable.

M4B merge

Combine múltiples audio files en single m4b. Embed metadata, cover.

Metadata autocomplete

Fetch cover, author, narrator, duration de Audible, Libby, etc.

Chromecast

Cast audiobook/podcast a TV/speakers. Web + Android app support.

Progressive Web App

PWA responsive. Install en home screen. Works offline.

iOS/Android apps

Apps nativas beta. Play Store + TestFlight. Full open source.

Ebook support

Epub, PDF, CBR, CBZ. Ereader. Send a Kindle device.

Auto-detect library

Detecta cambios automático. No re-scan manual needed.

Requisitos del sistema

  • Docker & Docker Compose v2+
  • 2 GB - 4 GB RAM mínimo (NodeJs app, FFmpeg)
  • 50 GB - 1TB+ espacio disco (según biblioteca audiobooks/podcasts)
  • Puerto TCP: 13378 (web UI, default) - configurable
  • NodeJs 20+ (bundled en imagen Docker)
  • FFmpeg (bundled en imagen Docker para transcode audio)
  • Opcional: Reverse proxy nginx/Apache + HTTPS
  • Opcional: External storage NAS (para biblioteca grande)
⚠️ Frontend rewrite in progress: Vue.js actual, React coming. No breaking changes esperados pero asume possible UI changes. Stay updated con releases.
Organización biblioteca: Directorio structure importante. Audiobooks: /audiobooks/Author/Series/Book/. Podcasts: /podcasts/PodcastName/. Lee docs library organization.

Instalación con Docker Compose

Paso 1: docker-compose.yml

version: '3.8' services: audiobookshelf: image: advplyr/audiobookshelf:latest container_name: audiobookshelf restart: unless-stopped ports: - "13378:13378" environment: - AUDIOBOOKSHELF_UID=1000 - AUDIOBOOKSHELF_GID=1000 volumes: - ./audiobooks:/audiobooks - ./podcasts:/podcasts - ./config:/config - /etc/timezone:/etc/timezone:ro healthcheck: test: ["CMD", "curl", "-f", "http://localhost:13378/health"] interval: 30s timeout: 10s retries: 3 volumes: audiobooks: podcasts: config:

Paso 2: Iniciar Audiobookshelf

# Guardar como docker-compose.yml docker compose up -d # Espera ~10 segundos para que inicie docker compose logs -f audiobookshelf # Debería ver "Server started" cuando listo

Acceder a Audiobookshelf

🎧 Audiobookshelf Web UI: http://localhost:13378

Setup inicial (primer acceso)

  1. Abre http://localhost:13378
  2. Setup wizard automático → crea admin user
  3. Ingresa username, email, password admin
  4. Configura rutas biblioteca (audiobooks, podcasts, ebooks)
  5. Dashboard aparece
  6. Sube/organiza audiobooks + subscribe podcasts
  7. ¡Empezar a escuchar!
💡 Desde otros dispositivos: Usa la IP de tu servidor:
http://192.168.1.100:13378
Para obtener tu IP: hostname -I

Primeros pasos

1. Setup biblioteca audiobooks

  1. Dashboard → Libraries → Create library
  2. Type: Audiobooks
  3. Path: /audiobooks (o tu path)
  4. Folder matching: elige estructura (Author, Series, etc)
  5. Save → Audiobookshelf scannea

2. Organizar audiobooks en disco

Estructura esperada (importante!):

/audiobooks/ ├── Stephen King/ │ ├── The Shining/ │ │ ├── 01-chapter.mp3 │ │ ├── 02-chapter.mp3 │ │ └── cover.jpg │ └── IT/ │ └── it-full.m4b └── Agatha Christie/ └── Murder on the Orient Express/

3. Crear biblioteca podcasts

  1. Dashboard → Libraries → Create library
  2. Type: Podcasts
  3. Path: /podcasts
  4. Save

4. Subscribir a podcasts

  1. Podcasts tab → Search podcast
  2. Click podcast → Subscribe
  3. Enable auto-download (opcional)
  4. Episodes descargan automático o on-demand

5. Crear usuarios adicionales

  1. Settings → Users → Create user
  2. Username, email, password
  3. Permissions: configure library access
  4. Save → usuario puede loguear

6. Usar app iOS/Android

  1. Descarga Audiobookshelf app (Play Store / TestFlight beta)
  2. Settings → Server: ingresa http://192.168.1.100:13378
  3. Username + password
  4. Streams desde servidor automático

7. Usar Progressive Web App (PWA)

  1. Web app → Menu → Install app
  2. Instala en home screen (mobile)
  3. Abre like app nativa
  4. Works offline (cached content)

8. Setup Chromecast

  1. Web app → Select audiobook
  2. Play → Chromecast icon
  3. Selecciona TV/speakers en network
  4. Stream starts playing en device

9. Bulk upload audiobooks

  1. Settings → Library → Drag-drop folder audiobooks
  2. Audiobookshelf importa + organiza automático
  3. Metadata fetches de Audible, Libby, etc

10. Criar RSS feeds

  1. Audiobook/Podcast → click tres puntos
  2. Generate RSS feed
  3. Copia URL → suscribe en apps podcast (Apple Podcasts, Pocketcasts)

Casos de uso

  • Biblioteca audiobooks personal: Todas tus compras DRM-free en un server. Play anywhere.
  • Podcaster: Host tu propio podcast. RSS feed. Multi-user (team members).
  • Family sharing: Share audiobooks + podcasts con familia. Cuentas separadas, progress independiente.
  • Offline listening: PWA + offline mode. Escucha sin internet.
  • Ebook integration: Combine audiobooks + ebooks. Send Kindle. Sincronizado.
  • Chromecast living room: Stream audiobooks a speakers. Family enjoy juntos.

Gestión y mantenimiento

Ver estado

docker compose ps

Ver logs

docker compose logs -f audiobookshelf

Detener Audiobookshelf

docker compose down

Actualizar versión

docker compose pull docker compose up -d

Backup config + metadata

docker compose exec audiobookshelf tar czf /config/backup.tar.gz /config docker cp audiobookshelf:/config/backup.tar.gz ./backup.tar.gz

Monitorear consumo

docker stats audiobookshelf # Típicamente: # CPU: 0-5% idle # RAM: 300-600MB # Pico durante transcode: 1-2 CPU cores

Rescan biblioteca manual

docker compose exec audiobookshelf npm run scanner # O desde web UI: Library → Scan button

Stack técnico

  • Backend: NodeJs 20+
  • Frontend: Vue.js (React migration en progress)
  • Database: SQLite (embedded, no dependencies)
  • Audio processing: FFmpeg (transcode, metadata)
  • API: REST + WebSockets (realtime)
  • Architecture: Monolithic self-contained
  • Deployment: Docker, Unraid template, source code
  • Licencia: GPL-3.0 open source

Comparativa con alternativas

vs Audible (cloud)

Audiobookshelf gana: Self-hosted, open source, no DRM, control total. Audible gana: Managed service, huge library, cloud sync built-in.

vs Plex

Audiobookshelf gana: Diseñado audiobooks/podcasts, mejor UX audio. Plex gana: Más versátil (movies, music, shows), UI pulida.

vs Podcast Addict + standalone audiobook player

Audiobookshelf gana: Unified platform, sync progress multi-device, multi-user. Standalone gana: Más simple setup.

Mejor para: Audiophiles. Podcast lovers. Self-hosted. Open source. Family sharing. DRM-free libraries.

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 »