Actualizado el 25 de marzo de 2026
Instalar Samba en Home Assistant es, en mi experiencia, uno de los primeros pasos que transforman la gestión de nuestro hogar inteligente de una tarea técnica a una experiencia fluida y eficiente. En 2026, con sistemas domóticos cada vez más complejos, tener acceso directo y sencillo a los archivos de configuración es fundamental. A través de Samba, podemos editar automatizaciones, gestionar copias de seguridad y añadir contenido multimedia como si se tratara de una carpeta más en nuestro ordenador. En esta guía definitiva, desglosaremos el proceso de instalación y configuración paso a paso para que puedas dominar el acceso a los archivos de Home Assistant en tu red local de forma rápida y segura.
¿Qué es Samba y por qué lo necesitas en Home Assistant en 2026?
Samba es la implementación del protocolo SMB (Server Message Block), un estándar de facto creado por Microsoft para compartir archivos en una red local. Piensa en ello como el lenguaje universal que permite que tu PC con Windows, tu Mac o tu móvil con Android puedan ver y editar archivos que están alojados en otro dispositivo, en este caso, tu instancia de Home Assistant. Su robustez y compatibilidad lo han convertido en una solución integrada en routers, discos NAS (como los de Synology) y, por supuesto, en el corazón de nuestra domótica.
Para Home Assistant, tener Samba significa que ya no necesitas herramientas complejas como SSH o el editor de archivos web para tareas cotidianas. Simplemente abres una carpeta en tu ordenador, introduces una contraseña y tienes acceso total a la estructura de directorios de Home Assistant. Esto es especialmente útil para editar archivos YAML, gestionar los backups que has creado con la integración de Google Drive, o subir archivos de sonido para tus notificaciones personalizadas.
Guía para Instalar y Configurar Samba en Home Assistant
El proceso para habilitar el acceso a los archivos es muy directo gracias al sistema de Apps (anteriormente conocidos como Add-ons) de Home Assistant. En pocos minutos lo tendrás funcionando.
1. Instalación de la App «Samba Share»
El primer paso es instalar la aplicación oficial. Sigue esta ruta dentro de tu interfaz de Home Assistant:
- Ve a Ajustes > Apps.
- En la esquina inferior derecha, haz clic en el botón Tienda de Apps.
- Utiliza la barra de búsqueda para encontrar «Samba share«.
- Selecciónala y pulsa el botón Instalar. El proceso tardará unos instantes.
2. Configuración Esencial
Antes de iniciar la App, es crucial configurarla. Ve a la pestaña Configuración dentro de la página de Samba share. Aquí verás un pequeño editor de texto en formato YAML. Recomiendo la siguiente configuración básica para empezar:
workgroup: WORKGROUP
username: tu_usuario
password: 'tu_contraseña_segura'
interface: ''
allow_hosts:
- 192.168.1.0/24
veto_files:
- ._*
- .DS_Store
- Thumbs.db
- .Trashes
compatibility_mode: false
Analicemos las claves más importantes:
- username: Elige un nombre de usuario fácil de recordar para acceder.
- password: ¡Crítico! Usa una contraseña fuerte y única. No reutilices la de tu Home Assistant.
- allow_hosts: Define qué dispositivos pueden conectarse. El valor
192.168.1.0/24permite el acceso a cualquier dispositivo dentro de la red 192.168.1.X. Adapta esta IP a la de tu red local para una mayor seguridad. Si quieres mejorar aún más la protección, te recomiendo leer mi guía sobre cómo segmentar tu red doméstica. - veto_files: Esta opción es muy útil para evitar que se creen archivos temporales o basura (típicos de macOS o Windows) en tus carpetas de Home Assistant. Es mejor dejarla como está.
Una vez editada la configuración, pulsa Guardar. Ahora, vuelve a la pestaña Información y activa las opciones «Iniciar en el arranque» y «Vigilante». Finalmente, pulsa Iniciar.
Acceso y Casos de Uso Prácticos
Con Samba operativo, ya puedes acceder a tus carpetas. El método varía ligeramente según tu sistema operativo:
- Desde Windows: Abre el Explorador de Archivos y en la barra de direcciones escribe
\\ip_de_home_assistant(ej:\\192.168.1.100) y pulsa Enter. Te pedirá el usuario y la contraseña que configuraste. - Desde macOS o Linux: Abre tu gestor de archivos (Finder en macOS) y busca una opción como «Conectar al servidor». Introduce
smb://ip_de_home_assistant(ej:smb://192.168.1.100).
Una vez dentro, verás una estructura de carpetas clave. Aquí tienes una tabla con las más importantes y para qué las uso yo habitualmente:
| Directorio | Descripción y Uso Práctico en 2026 |
|---|---|
| config | El corazón de tu sistema. Aquí resides el famoso configuration.yaml y puedes editar tus personalizaciones, crear sensores complejos o gestionar los secretos de tu instalación a través del archivo secrets.yaml. |
| backup | Contiene todas las copias de seguridad (snapshots) que has creado. Es perfecto para descargar una copia a tu PC antes de una actualización importante o para restaurar el sistema si algo falla. |
| media | El lugar ideal para almacenar archivos multimedia. Yo guardo aquí imágenes para mis dashboards, sonidos para las notificaciones de la alarma y vídeos que reproduzco en mis dispositivos a través de automatizaciones. |
| share | Una carpeta de intercambio. Algunas Apps, como Zigbee2MQTT, la utilizan para exportar datos o registros. También es útil para pasar archivos entre Home Assistant y otros servicios. |
| ssl | Si configuras el acceso remoto de forma manual (sin Nabu Casa), aquí es donde guardarás tus certificados SSL para una conexión segura. |
| addons | Para los desarrolladores o usuarios avanzados. Aquí puedes alojar Apps locales o personalizadas que no están en la tienda oficial. |
Solución de Problemas Comunes y Alternativas
Aunque la instalación es sencilla, a veces pueden surgir problemas. El más común es el de «acceso denegado». Casi siempre se debe a un error en la contraseña o a que la IP de tu ordenador no está incluida en la lista `allow_hosts` de la configuración. Revisa esos dos puntos y reinicia la App desde la interfaz de Home Assistant.
Si bien Samba es mi opción preferida para la gestión de archivos, en 2026 existen otras alternativas interesantes:
- App «Visual Studio Code»: Permite editar todos tus archivos de configuración directamente desde el navegador, con un editor de código muy potente. Es ideal para programar en YAML, pero no sirve para mover archivos grandes como vídeos o backups.
- Acceso por SSH/SFTP: Para los usuarios más técnicos, la App «Advanced SSH & Web Terminal» ofrece un acceso más profundo al sistema. Es más complejo pero también más potente.
Conclusión: Una Herramienta Imprescindible
En definitiva, instalar Samba en Home Assistant en 2026 es un paso fundamental para optimizar tu flujo de trabajo y simplificar la administración de tu hogar inteligente. La capacidad de gestionar archivos de configuración, copias de seguridad y contenido multimedia de forma nativa desde tu ordenador te ahorrará incontables horas y te permitirá centrarte en lo que de verdad importa: crear un hogar más inteligente y automatizado.