Skip to main content
[ PIER ]

Berth

Un servidor de audiolibros autoalojado y ligero con apps para Android e iOS.

Service#audiobook#media#library#s3#mobile

Berth es un servidor de audiolibros de código abierto escrito en Rust. Sube libros desde el panel web, guarda los archivos en disco local, almacenamiento compatible con S3 o Google Drive, y escúchalos en la app Berth para Android e iOS — los teléfonos se conectan escaneando un código QR.

Desplegar con Pier

  1. 1Abre el panel de Pier y haz clic en Add service.
  2. 2Elige Berth en la lista de plantillas.
  3. 3Elige la versión, asigna un nombre al servicio y Pier provisionará automáticamente el contenedor, el almacenamiento y los puertos.
  4. 4Vincula un dominio si quieres HTTPS. Traefik genera el certificado de Let's Encrypt automáticamente.

¿Qué es Berth?

Berth es un servidor de audiolibros autoalojado escrito en Rust. Subes libros desde un panel web, guardas los archivos en disco local, cualquier almacenamiento compatible con S3 o Google Drive, y escuchas en la app Berth para Android e iOS. Los teléfonos se conectan escaneando un código QR.

A diferencia de los servidores multimedia que escanean carpetas, Berth trata su base de datos como fuente de verdad: los libros son entidades que gestionas en el panel, y el audio puede entregarse directamente desde el almacenamiento de objetos o un CDN mediante URLs firmadas.

Cómo lo despliega Pier

Pier usa la imagen oficial ghcr.io/joveptesg/berth (amd64 y arm64). Puerto 8080 interno, detrás de Traefik. Un volumen persistente — /data — para la base de datos SQLite, los backups previos a migraciones, el almacenamiento local y secret.key.

No hay credenciales por defecto. Tras el primer arranque abre los logs del servicio en Pier y sigue el enlace de configuración para crear el administrador. Asocia un dominio y configúralo en Settings → Internet address para que los códigos QR apunten a la URL HTTPS pública. Guarda una copia de secret.key fuera de los backups.

Cuándo NO usar Berth

Si quieres podcasts y ebooks en la misma app, o una biblioteca construida escaneando carpetas existentes, usa Audiobookshelf. Para vídeo, Plex o Jellyfin. Berth está en desarrollo temprano — mantén backups.

Características clave

Panel web para libros y usuarios

Sube audiolibros, gestiona la biblioteca e invita oyentes desde el navegador. La base de datos es la fuente de verdad — los libros son entidades, no carpetas escaneadas.

Apps para Android e iOS

Escucha en la app móvil Berth. Los teléfonos se conectan a tu servidor escaneando un código QR del panel, sin escribir URLs.

Almacenamiento local, S3 o Google Drive

Guarda los archivos en el disco del servidor o en cualquier bucket compatible con S3 — AWS, Cloudflare R2, Backblaze B2, MinIO, Yandex Object Storage — o en Google Drive.

Entrega con URLs firmadas

El audio puede servirse directamente desde el almacenamiento de objetos o un CDN mediante URLs firmadas de corta duración. El servidor solo autoriza el acceso.

Backups integrados

Antes de cada migración de esquema Berth hace un backup automático de la base de datos (se guardan los 3 últimos). Descarga, sube y restaura backups en Settings → Backup.

API JSON

API JSON versionada (v1) con contrato OpenAPI para scripts e integraciones.

Casos de uso

Biblioteca familiar de audiolibros

Un servidor para todo el hogar — se sube una vez y cada uno escucha en su propio teléfono.

Audiolibros en almacenamiento de objetos barato

Guarda una colección grande en R2 o B2 y ejecuta el servidor en un VPS pequeño — la reproducción va directamente desde el bucket.

Libros sin DRM que te pertenecen

Una estantería privada para audiolibros comprados sin DRM o producidos por ti, sin suscripción ni cuentas de terceros.

Equipos ARM pequeños

La imagen se compila para amd64 y arm64, así que funciona en una Raspberry Pi o un NAS ARM además de en un VPS.

Ejemplos de código

Lo que ejecuta Pieryaml
# Pier lo genera automáticamente — solo ilustrativo
services:
  berth:
    image: ghcr.io/joveptesg/berth:latest
    volumes:
      - berth-data:/data
    # puerto 8080, publicado a través de Traefik en tu dominio
Encuentra el enlace de configuracióntext
Berth no tiene credenciales por defecto.
Abre el servicio → Logs en el panel de Pier y sigue el
enlace de configuración de un solo uso impreso al primer arranque.
Apunta los códigos QR a tu dominiotext
Admin → Settings → Internet address:
  https://books.example.com
Los códigos QR que verán los oyentes incluirán esta dirección.

Comparativa

vs AudiobookshelfAudiobookshelf escanea carpetas en disco y también cubre podcasts y ebooks. Berth es solo para audiolibros, guarda los libros como entidades en la base de datos y está pensado para almacenamiento remoto (S3, Google Drive) con URLs firmadas.
vs AudibleAudible es SaaS con DRM. Berth aloja archivos que te pertenecen en un servidor que controlas.
vs Plex / JellyfinLos servidores multimedia generales tratan los audiolibros como álbumes de música. Berth está hecho para escuchar libros en el teléfono.

Preguntas frecuentes

¿Cuáles son las credenciales por defecto?
No hay. Al primer arranque Berth imprime en su log un enlace de configuración de un solo uso — abre los logs del servicio en Pier y síguelo para crear el administrador.
¿Qué volumen debo respaldar?
/data — contiene la base de datos SQLite, los backups automáticos, el almacenamiento local y secret.key. Guarda una copia aparte de secret.key; sin él no se pueden leer las claves de almacenamiento.
¿Puedo poner /data en NFS o SMB?
No. Berth usa SQLite, que puede corromperse en recursos de red. Mantén /data en disco local y pon el audio en S3 o Google Drive si necesitas almacenamiento remoto.
¿Necesita HTTPS?
Berth sirve HTTP plano en el puerto 8080. Asocia un dominio en Pier y Traefik termina HTTPS delante.
¿Cómo actualizo?
Redespliega el servicio en Pier — descarga la imagen más reciente. Berth respalda la base de datos en /data/backups antes de migrar.
¿Cómo vuelvo atrás?
Restaura el backup previo a la actualización desde Settings → Backup (o con berth admin restore).

Servicios relacionados

Desplegar en tu VPS

Berth es un servidor de audiolibros de código abierto escrito en Rust. Sube libros desde el panel web, guarda los archivos en disco local, almacenamiento compatible con S3 o Google Drive, y escúchalos en la app Berth para Android e iOS — los teléfonos se conectan escaneando un código QR.

Desplegar este servicio →