diff --git a/servicios/musica/README.md b/servicios/musica/README.md
index ea70753..d2806ef 100644
--- a/servicios/musica/README.md
+++ b/servicios/musica/README.md
@@ -54,3 +54,42 @@ Lidarr (8686) ──► lista de álbumes/artistas que quieres
 - [ ] Tras eso, Soularr (cron cada 30 min) buscará y descargará automáticamente
 
 > ⚠️ Usar con contenido que se tenga derecho a descargar (compras propias, música libre, artistas que lo permitan).
+
+---
+
+## ⚠️ Configuración de slskd 0.26 — esquema YAML (Sept 2026)
+
+El slskd 0.26 **cambió los nombres de las secciones**; con el esquema viejo **ignora silenciosamente** la configuración (síntoma: `Not connecting to the Soulseek server; username and/or password invalid` + escucha en el puerto default 50300 en vez del configurado).
+
+Esquema **correcto** (`/opt/slskd/slskd.yml`):
+
+```yaml
+directories:
+  downloads: /var/lib/slskd/downloads
+  incomplete: /var/lib/slskd/incomplete
+web:
+  port: 5030
+  authentication:
+    username: admin
+    password: Slskd2026!
+    api_keys:            # ← dentro de authentication (no como hermana de web)
+      - id: soularr
+        key: f62d4b3d70a3092dd9530c99736a2a5a
+soulseek:                # ← era `slskd:` en versiones viejas
+  username: Fransacreblue
+  password: Aasi940812
+  listen_port: 50300
+```
+
+### Verificación
+
+```bash
+journalctl -u slskd -n 20 | grep -iE "logged|listening"   # debe decir: Logged in ... as Fransacreblue
+curl -s -H "X-API-Key: <key>" http://127.0.0.1:5030/api/v0/session   # 200 = API OK
+```
+
+### Cuenta Soulseek
+
+- Usuario: **Fransacreblue** (creada por el usuario vía cliente Nicotine+, IP residencial)
+- Con CGNAT no somos "connectable" (los peers no nos alcanzan), pero **búsqueda y descarga funcionan** vía conexiones indirectas — verificado: búsqueda de prueba devolvió 123 peers / 5,352 archivos.
+- **NOTA**: los endpoints de la API de slskd para resultados están en `/searches/{id}/responses` (no en `/searches/{id}`).