🎵 Guía Completa de Navidrome

Instalación y Primeros Pasos con tu Servidor de Música Personal

Open Source • Multiplataforma • Compatible con Subsonic

¿Qué es Navidrome?

Navidrome es un servidor de música personal Open Source que te permite acceder a tu colección de música desde cualquier lugar. Es compatible con aplicaciones Subsonic/Airsonic, lo que significa que puedes usar cientos de clientes móviles y de escritorio.

Con Navidrome, puedes:

Acceder a tu música desde cualquier dispositivo
Crear listas de reproducción
Transcodificar música para diferentes dispositivos
Compartir tu música con amigos y familia
Usar aplicaciones móviles populares como DSub, Symfonium, etc.

⚙️ Requisitos del Sistema

Antes de instalar Navidrome, asegúrate de tener:

Hardware Mínimo

Procesador: 1 GHz o superior
RAM: 512 MB (recomendado 1 GB)
Almacenamiento: Espacio para tu biblioteca musical

Sistemas Operativos

Linux (recomendado)
Windows 7 o superior
macOS 10.12+
Docker

Software Adicional

FFmpeg (para transcodificación)
Acceso SSH (para servidores remotos)
Puerto 4533 abierto

🚀 Métodos de Instalación

1. Instalación en Linux (Recomendado)

Paso 1: Descargar Navidrome

                    wget https://github.com/navidrome/navidrome/releases/latest/download/navidrome_0.50.0_Linux_x86_64.tar.gz

tar -xzf navidrome_0.50.0_Linux_x86_64.tar.gz

cd navidrome_0.50.0_Linux_x86_64

Paso 2: Crear Usuario y Permisos

                    sudo useradd -r navidrome

sudo mkdir -p /opt/navidrome

sudo chown -R navidrome:navidrome /opt/navidrome

Paso 3: Configurar como Servicio

sudo nano /etc/systemd/system/navidrome.service

Copia el siguiente contenido:

                    [Unit]

Description=Navidrome Music Server

After=network.target

[Service]

User=navidrome

Group=navidrome

ExecStart=/opt/navidrome/navidrome --musicfolder /path/to/your/music

Restart=on-failure

[Install]

WantedBy=multi-user.target

Paso 4: Iniciar el Servicio

                    sudo systemctl daemon-reload

sudo systemctl enable navidrome

sudo systemctl start navidrome

sudo systemctl status navidrome

2. Instalación con Docker

Método Docker Compose

                    version: '3'

services:

  navidrome:

    image: deluan/navidrome:latest

    container_name: navidrome

    restart: unless-stopped

    user: 1000:1000

    ports:

      - "4533:4533"

    environment:

      - ND_MUSICFOLDER=/music

      - ND_DATAFOLDER=/data

      - ND_LOGLEVEL=info

    volumes:

      - /path/to/your/music:/music:ro

      - /path/to/navidrome/data:/data

Iniciar con:

docker-compose up -d

3. Instalación en Windows

Paso 1: Descargar y Extraer

Descarga el archivo .zip desde GitHub Releases y extráelo en una carpeta.

Paso 2: Crear Archivo de Configuración

Crea un archivo navidrome.toml con:

                    MusicFolder = "C:\\Path\\To\\Your\\Music"

DataFolder = "C:\\Path\\To\\Navidrome\\Data"

Port = 4533

LogLevel = "info"

Paso 3: Ejecutar

navidrome.exe --config navidrome.toml

Para ejecutar como servicio, usa NSSM o similar.

🔧 Configuración Inicial

Accediendo por Primera Vez

Una vez instalado, abre tu navegador y navega a:

http://localhost:4533

Si estás accediendo desde otro dispositivo en tu red:

http://TU_IP_LOCAL:4533

💡 Consejo: Para encontrar tu IP local en Linux: ip addr show
En Windows: ipconfig
En macOS: ifconfig

Creación del Usuario Administrador

En la primera visita, se te pedirá crear un usuario administrador:

Ingresa tu nombre de usuario deseado
Crea una contraseña segura
Confirma tu contraseña
Haz clic en "Crear cuenta"

Configuración Básica

Después de iniciar sesión, ve a Configuración → Preferencias:

Nombre del Servidor: Dale un nombre identificativo
Idioma: Selecciona tu idioma preferido
Tema: Elige entre Light, Dark o Auto
Calidad de Transcodificación: Ajusta según tu conexión

Configuración Avanzada (navidrome.toml)

Para configuraciones avanzadas, edita el archivo navidrome.toml:

                # Puerto de escucha

Port = 4533

# Carpetas

MusicFolder = "/path/to/music"

DataFolder = "/path/to/data"

# Cache

CacheSize = "200MiB"

# Transcodificación

TranscodingCachingSize = "100MiB"

# Seguridad

BaseURL = ""

BasePath = ""

# Logging

LogLevel = "info"

🎯 Primeros Pasos

1. Escanear tu Biblioteca Musical

Navidrome escaneará automáticamente tu carpeta de música. Para forzar un escaneo manual:

Ve a Configuración → Biblioteca
Haz clic en "Escanear ahora"
Espera a que termine el proceso

⚠️ Importante: El primer escaneo puede tardar varios minutos dependiendo del tamaño de tu biblioteca.

2. Organizar tu Música

Navidrome organiza automáticamente tu música por:

Artistas - Agrupados por nombre de artista
Álbumes - Organizados por álbum
Géneros - Categorizados por género musical
Años - Filtrados por año de lanzamiento

3. Crear Listas de Reproducción

Navega a cualquier canción, álbum o artista
Haz clic en el menú de tres puntos (⋮)
Selecciona "Añadir a lista de reproducción"
Elige una lista existente o crea una nueva

4. Configurar Transcodificación

Para optimizar el streaming en dispositivos móviles:

Ve a Configuración → Transcodificación
Selecciona el formato de salida (MP3 recomendado)
Ajusta la calidad de bits (128-320 kbps)
Guarda los cambios

📱 Clientes Recomendados

Aplicaciones Móviles

DSub (Android)

La aplicación más popular para Android. Interfaz limpia y muchas funciones.

Precio: Gratuito (con anuncios) / $4.99 (Pro)

Symfonium (iOS/Android)

Excelente aplicación con diseño moderno y excelente rendimiento.

Precio: $4.99 (única)

Substreamer (iOS)

Aplicación nativa para iOS con buena integración con el sistema.

Precio: $4.99

Clientes de Escritorio

Strawberry Music Player - Windows/Linux/macOS
Clementine - Multiplataforma
Tomahawk - Moderno y con integración social
Nuclear Music Player - Electron-based, multiplataforma

Configuración del Cliente

Para configurar cualquier cliente Subsonic:

URL del servidor: http://TU_IP:4533
Nombre de usuario: Tu usuario de Navidrome
Contraseña: Tu contraseña
Formato de streaming: MP3 (recomendado)

💡 Consejos y Trucos

Optimización del Rendimiento

Usa SSD: Para la carpeta de datos de Navidrome
Cache adecuado: Ajusta CacheSize según tu RAM disponible
FFmpeg optimizado: Instala FFmpeg con codecs completos
Red local rápida: Usa Gigabit Ethernet si es posible

Seguridad

Cambia el puerto: Usa un puerto diferente a 4533
HTTPS: Configura un proxy inverso con SSL
Firewall: Restringe el acceso solo a IPs confiables
Contraseñas fuertes: Usa contraseñas complejas para todos los usuarios

Backup y Mantenimiento

Backup de la Base de Datos

Copia regularmente la carpeta de datos:

cp -r /path/to/navidrome/data /backup/navidrome-$(date +%Y%m%d)

Actualización

Para actualizar Navidrome:

Detén el servicio: sudo systemctl stop navidrome
Descarga la nueva versión
Reemplaza el binario
Inicia el servicio: sudo systemctl start navidrome

🔧 Solución de Problemas

Navidrome no se inicia

Verifica los logs: sudo journalctl -u navidrome
Comprueba permisos de carpetas
Verifica que el puerto 4533 no esté en uso
Revisa el archivo de configuración por errores

Música no aparece

Ejecuta un escaneo manual desde la interfaz
Verifica que las rutas de las carpetas sean correctas
Comprueba permisos de lectura en la carpeta de música
Revisa los formatos de archivo soportados

Problemas de rendimiento

Aumenta el tamaño de cache en navidrome.toml
Reduce la calidad de transcodificación
Verifica el uso de CPU y RAM
Considera usar un servidor más potente

Conexión desde dispositivos móviles

Asegúrate de que el dispositivo esté en la misma red WiFi
Usa la IP local correcta del servidor
Verifica que el firewall permita el puerto 4533
Prueba con diferentes aplicaciones cliente

📚 Recursos Adicionales:
Documentación Oficial • GitHub Issues • Discord Comunidad

Guía Completa de Navidrome - Instalación y Primeros Pasos