Guía

Tu propio servidor de música en una Raspberry Pi

Una Raspberry Pi es una forma silenciosa y de bajo consumo de tener toda tu colección de música en casa y escucharla desde cualquier sitio. Esta guía monta una con Navidrome, un servidor de música gratuito y de código abierto que funciona con soltura en una Pi, y le conecta Audex. Calcula unos 30 minutos, la mayor parte esperando descargas.

Unos 30 minutos Raspberry Pi 3, 4 o 5 Navidrome + Docker

Qué necesitas

Una Raspberry Pi 4 o 5 (una Pi 3 también sirve). Navidrome necesita muy poco; 2 GB de memoria son de sobra.
Una tarjeta microSD de 16 GB o más, y la fuente de alimentación de la Pi. Para una colección grande, un SSD USB es mejor que la tarjeta.
Una conexión de red. Un cable al router es lo más fiable; la wifi también sirve.
Un ordenador para preparar la tarjeta y copiar tu música, en la misma red que la Pi.
Tus archivos de música (MP3, FLAC, M4A, OGG, Opus y similares) y Audex en tu teléfono.

¿Prefieres verlo antes?

Este vídeo muestra cómo se instala Navidrome en una Raspberry Pi 5, y después cómo corregir las etiquetas de las canciones y añadir radio por internet. Los pasos de abajo siguen la instalación oficial de Navidrome con Docker, así que los comandos difieren un poco del vídeo; ambos terminan con el mismo servidor. (El vídeo está en inglés.)

Navidrome se instala a partir del minuto 4:29. Vídeo de Jeffs Pi in the Sky, sin relación con Audex. No se carga nada de YouTube hasta que pulsas reproducir. Ver en YouTube

1. Prepara la Raspberry Pi

Instala Raspberry Pi OS en la tarjeta
Instala Raspberry Pi Imager en tu ordenador, elige tu modelo de Pi y luego Raspberry Pi OS Lite (64-bit) en «Raspberry Pi OS (other)». En un servidor no necesitas escritorio.
Descargar Raspberry Pi Imager
Rellena los ajustes antes de grabar
Cuando Imager te ofrezca personalizar el sistema, pon un nombre de equipo como audex-pi, un usuario y una contraseña, tu wifi si no usas cable, y activa SSH con inicio de sesión por contraseña. Después graba la tarjeta, ponla en la Pi y enciéndela. El primer arranque tarda unos minutos.
Conéctate a la Pi desde tu ordenador
Abre un terminal (PowerShell en Windows, Terminal en macOS o Linux) e inicia sesión con el usuario que elegiste:
```
ssh yourname@audex-pi.local
```
Si no encuentra audex-pi.local, usa la dirección IP de la Pi que aparece en la lista de dispositivos de tu router.

Actualízala

sudo apt update && sudo apt full-upgrade -y

2. Instala Navidrome

Instala Docker
Docker ejecuta Navidrome en un contenedor fácil de actualizar. Esto usa el script de instalación oficial de Docker y luego permite a tu usuario usarlo sin sudo:
```
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER
```
Escribe exit y vuelve a iniciar sesión con ssh para que el cambio surta efecto.
Crea carpetas para Navidrome y tu música
```
mkdir -p ~/navidrome/data ~/music
```
Copia tu música a la Pi
Desde un terminal de tu ordenador (no de la Pi), copia una carpeta de música. Repite para cada carpeta o copia toda tu biblioteca de una vez:
```
scp -r "Path/To/Your Music Folder" yourname@audex-pi.local:music/
```
Una biblioteca grande se copia más rápido desde una unidad USB conectada a la Pi. Mantén una carpeta por artista o álbum; Navidrome lee las etiquetas de los archivos de todos modos.
Describe el servidor en un archivo Compose
De vuelta en la Pi, abre un archivo nuevo:
```
nano ~/navidrome/compose.yaml
```
Pega esto y guarda con Ctrl+O, Intro, y cierra con Ctrl+X:
```
services:
  navidrome:
    image: navidrome/navidrome:latest
    user: 1000:1000
    ports:
      - "4533:4533"
    restart: unless-stopped
    volumes:
      - ./data:/data
      - ../music:/music:ro
```
1000:1000es el primer usuario de Raspberry Pi OS, el que creaste. La carpeta de música se monta en solo lectura, así que Navidrome nunca puede cambiar tus archivos.
Ponlo en marcha
```
cd ~/navidrome
docker compose up -d
```
El primer arranque descarga Navidrome. restart: unless-stopped lo vuelve a arrancar solo cada vez que la Pi se reinicia.
Crea tu cuenta de Navidrome
En un navegador de tu ordenador, abre http://audex-pi.local:4533 y crea el primer usuario; será el administrador. Después Navidrome analiza tu carpeta de música por sí solo y los álbumes aparecen en pocos minutos.
Dale a la Pi una dirección fija
Averigua la dirección de la Pi con hostname -I y resérvala en los ajustes de tu router (suele llamarse reserva DHCP o IP estática). Así la dirección que le das a Audex nunca cambia.

3. Conecta Audex

Añade el servidor
En Audex, abre Ajustes → Servidores multimedia → Añadir servidor y elige Subsonic / OpenSubsonic / Navidrome. (Los servidores Jellyfin, Emby y Kodi aparecen solos en En esta red; Navidrome no se anuncia en la red, así que lo añades por su dirección.)
Escribe su dirección y tus credenciales
Usa la dirección y el puerto de la Pi, por ejemplo http://192.168.1.50:4533, con el usuario y la contraseña de Navidrome que acabas de crear. Audex prueba la conexión antes de guardar, así que sabrás al instante que funciona.
Activa Reproducir en calidad original
En el mismo formulario (o más tarde, en la página del servidor en Ajustes → Servidores multimedia), activa Reproducir en calidad original. La Pi enviará tus archivos tal cual en vez de convertirlos, lo que la mantiene fresca y rápida. Fuera de casa gasta más datos móviles, así que déjalo desactivado si tu tarifa es pequeña.
Reproduce algo
Elige el servidor en el selector de fuentes, arriba en la Biblioteca. Los álbumes, artistas, géneros y listas aparecen tal como los organiza Navidrome, y todo se puede descargar para escucharlo sin conexión.

Opcional: escucha fuera de casa

Tu Pi solo es accesible en tu red doméstica hasta que añadas una forma de entrar desde fuera. La más sencilla y segura es una VPN privada como Tailscale, que no requiere tocar el router:

Instala Tailscale en la Pi e inicia sesión
```
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
```
Abre el enlace que muestra para iniciar sesión e instala la app de Tailscale en tu teléfono con la misma cuenta.
Conseguir Tailscale
Añádela como segunda dirección del servidor
Edita el servidor en Audex y pon la dirección Tailscale de la Pi (empieza por 100., más :4533) en Segunda dirección (opcional). En casa, Audex usa tu dirección de casa; cuando no responde, cambia por sí solo a la segunda.

¿Usas HTTPS con un certificado autofirmado? Audex muestra los detalles del certificado y su huella SHA-256 la primera vez, para que confíes exactamente en ese certificado. Si alguna vez cambia, Audex se detiene y te pregunta antes de volver a conectarse.

Si algo no funciona

Navidrome se abre, pero la biblioteca está vacía

Navidrome no puede leer la carpeta de música. Haz que tu usuario sea su propietario y reinicia Navidrome:

sudo chown -R 1000:1000 ~/music ~/navidrome/data
cd ~/navidrome && docker compose restart

Audex no consigue conectar con el servidor

Comprueba que tu teléfono esté en la misma wifi que la Pi y que la dirección en Audex incluya :4533. En la Pi, docker compose ps (dentro de ~/navidrome) debería mostrar Navidrome en marcha. Si la dirección de la Pi cambió, resérvala en el router como en el paso 2.

¿Cómo actualizo Navidrome más adelante?

En la Pi:

cd ~/navidrome
docker compose pull && docker compose up -d

Tu cuenta y tus ajustes están en ~/navidrome/data y se conservan.

¿Puedo usar Jellyfin en la Pi en su lugar?

Sí. Jellyfin funciona bien para música en una Pi 4 o 5, y Audex se conecta igual (puerto 8096), normalmente encontrándolo solo en En esta red. Para vídeo, usa formatos que tus dispositivos reproduzcan directamente, porque una Pi no convierte vídeo con rapidez. Navidrome es la opción más ligera si solo necesitas música.

¿Sigues atascado? Escribe a audex@kymonic.com: una persona real lee cada mensaje.