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

🎵 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.

📋 Contenido

• Requisitos del Sistema
• Métodos de Instalación
• Configuración Inicial
• Primeros Pasos
• Clientes Recomendados
• Consejos y Trucos
• Solución de Problemas

⚙️ 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:

1. Ingresa tu nombre de usuario deseado
2. Crea una contraseña segura
3. Confirma tu contraseña
4. 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:

1. Ve a Configuración → Biblioteca
2. Haz clic en "Escanear ahora"
3. 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

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

4. Configurar Transcodificación

Para optimizar el streaming en dispositivos móviles:

1. Ve a Configuración → Transcodificación
2. Selecciona el formato de salida (MP3 recomendado)
3. Ajusta la calidad de bits (128-320 kbps)
4. 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:

1. URL del servidor: http://TU_IP:4533
2. Nombre de usuario: Tu usuario de Navidrome
3. Contraseña: Tu contraseña
4. 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:

1. Detén el servicio: sudo systemctl stop navidrome
2. Descarga la nueva versión
3. Reemplaza el binario
4. 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 de Navidrome - Instalación y Primeros Pasos

Última actualización: Febrero 2026

© 2026 Guía Navidrome - Contenido Open Source

Navidrome es software libre bajo licencia GPL v3.0