Tu biblioteca.
Tu servidor.

Clona el repositorio y crea la carpeta de música. Edita .env: MUSIC_DIR es la carpeta de tu música y PUBLIC_URL el origen al que se conectan tus apps, por ejemplo https://musica.tudominio.es, sin /api/v1.

git clone https://github.com/mateodd1/DoubleMusic.git
cd DoubleMusic
cp .env.example .env
mkdir -p music

Arranca con la imagen ya compilada:

docker compose -f compose.release.yml pull
docker compose -f compose.release.yml up -d

Crea tu cuenta. La contraseña se escribe en tu terminal y no queda en el historial:

read -r -s -p 'Contraseña: ' MUSIC_PASSWORD; printf '\n'
printf '%s\n' "$MUSIC_PASSWORD" | docker compose -f compose.release.yml exec -T doublemusic node cli.js add admin --admin --password-stdin
unset MUSIC_PASSWORD

¿El servidor no tiene acceso al registro? Carga el archivo descargado y verifica antes su suma:

sha256sum --check SHA256SUMS --ignore-missing
docker load -i doublemusic_*_linux_amd64.docker.tar.gz
DOUBLEMUSIC_IMAGE=doublemusic:1.4.1 docker compose -f compose.release.yml up -d --pull never

Instala el paquete con apt, que resuelve FFmpeg y las dependencias. En máquinas ARM64 usa arm64 en lugar de amd64.

sha256sum --check SHA256SUMS --ignore-missing
sudo apt install ./doublemusic_*_amd64.deb

El servicio se crea, pero no arranca solo: configúralo y crea una cuenta antes. Edita /etc/doublemusic/doublemusic.env y pon en PUBLIC_URL el origen de tus clientes, sin /api/v1. Tu música va en /srv/doublemusic/music o en la carpeta que indiques en MUSIC_DIR; el servicio no puede leer /home, así que usa /srv o /mnt. Escucha en 127.0.0.1:3000: pon delante un proxy HTTPS o usa HOST=0.0.0.0 si quieres exponerlo en tu red.

read -r -s -p 'Contraseña: ' MUSIC_PASSWORD; printf '\n'
printf '%s\n' "$MUSIC_PASSWORD" | sudo -u doublemusic doublemusic-user add admin --admin --password-stdin
unset MUSIC_PASSWORD
sudo systemctl enable --now doublemusic.service
sudo systemctl status doublemusic.service

Instala el paquete con dnf. Necesita FFmpeg (en Fedora, ffmpeg-free); otras distribuciones RPM requieren un proveedor compatible y sus repositorios activos. En ARM64 usa aarch64. Después, configura y arranca el servicio como en Debian y Ubuntu.

sha256sum --check SHA256SUMS --ignore-missing
sudo dnf install ./doublemusic-*.x86_64.rpm

Si prefieres compilar tú mismo, usa el docker-compose.yml del repositorio, que construye la imagen en tu máquina:

docker compose up -d --build

En la app escribe la misma URL que PUBLIC_URL e inicia sesión con esa cuenta. Tu proxy HTTPS debe reenviar todas las rutas al servicio, también las conexiones WebSocket de Connect.

La música se monta en solo lectura. En Docker, el volumen library-data guarda cuentas, bibliotecas personales, índice y caché; en los paquetes, /var/lib/doublemusic.

En el JSON indicado por SOURCES_FILE eliges si se usa la biblioteca local, las conexiones externas o ambas. Desactivar la biblioteca evita el escaneo; desactivar las externas impide cargar sus credenciales o consultarlas. Tus archivos, cuentas y bibliotecas personales se conservan.

{
  "version": 1,
  "library": { "enabled": true },
  "external": { "enabled": false }
}

Con Docker, móntalo creando compose.config.yml y aplícalo con docker compose -f compose.release.yml -f compose.config.yml up -d --force-recreate doublemusic. En los paquetes, edita /etc/doublemusic/settings.json. La guía de módulos explica el contrato de las conexiones externas.

services:
  doublemusic:
    environment:
      SOURCES_FILE: /config/settings.json
    volumes:
      - ./settings.json:/config/settings.json:ro

Las cuentas se gestionan desde la terminal del servidor. add y passwd reciben la contraseña por entrada estándar, como al crearla.

docker compose -f compose.release.yml exec doublemusic node cli.js list
docker compose -f compose.release.yml exec doublemusic node cli.js revoke usuario
docker compose -f compose.release.yml exec -T doublemusic node cli.js passwd usuario --password-stdin
docker compose -f compose.release.yml exec doublemusic node cli.js del usuario
docker compose -f compose.release.yml logs --tail=100 doublemusic

sudo -u doublemusic doublemusic-user list
sudo -u doublemusic doublemusic-user revoke usuario
sudo -u doublemusic doublemusic-user passwd usuario --password-stdin
sudo -u doublemusic doublemusic-user del usuario
sudo -u doublemusic doublemusic-server --healthcheck
sudo journalctl -u doublemusic.service -n 100 --no-pager

Actualizar. Con Docker, cambia la etiqueta de la imagen (DOUBLEMUSIC_IMAGE), descárgala y recrea el servicio con los mismos volúmenes. Con paquetes, instala el nuevo: se conservan la configuración, las cuentas, las sesiones y las bibliotecas personales.

Copias. Para una copia coherente, detén el servicio y copia el volumen library-data (Docker) o /var/lib/doublemusic (paquetes). Tu carpeta de música se respalda aparte. Quitar o purgar el paquete conserva la música y los datos.