Samba NAS for Home Assistant (app)

About

Samba NAS is a Home Assistant app that shares Home Assistant directories and disks over SMB/CIFS. It lets Windows and macOS machines reach the shares by the host's IP address. Settings cover the workgroup, local master browser behavior, a username and password, and the hosts or networks allowed to connect. It can mount labeled disks automatically and share extra disks or partitions by label or id, with filesystems such as ext4, vfat, exFAT, ntfs, xfs and btrfs listed as supported. It is built for Home Assistant OS and runs on armv7, aarch64 and amd64. The app is in maintenance mode, receiving only bug fixes, while a rewrite called SambaNas2 is in alpha.

Automatic summary of the docs and configuration of dianlight/hassio-addons. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Actively maintained Its author released or pushed a change in the last six months.

Setting it up

Add its app repository under Settings, Apps, then install and start it.

Permissions

Host networkUses the host's network directly instead of its own.
Extra system rightsAsks for privileged Linux capabilities.
Home Assistant APICan read and control Home Assistant.
Supervisor APICan talk to the Supervisor, which manages apps and the system.
Sign-in checksCan check Home Assistant usernames and passwords.
Full hardware accessRuns with full access to the host's hardware.

Configuration

UsernameThe username you would like to use to authenticate with the Samba server.
PasswordThe password that goes with the username configured for authentication.
WorkgroupChange WORKGROUP to reflect your network needs.
Local masterEnable to try and become a local master browser on a subnet.
Enabled Shares - allowed values are: addons, addon_configs, backup, config, media, share, or ssl.List of file shares to make available. Adding a share requires typing its name to add it. The listed values are the only allowed values. The configuration cannot be saved if any non-allowed value is in the list.
Enable Compatibility ModeEnable this to use old legacy Samba protocols on the Samba add-on.
Veto FilesList of files that are neither visible nor accessible.
Allowed HostsList of hosts/networks allowed to access the shared folders.
Enable Automatic MountAutomatic mount and expose all labeled disk.
List of labeled disk to mountList of disks or partitions label to search and share. It is also possible to use the disk id if you prepend the name with id:
Enable discovered disk logEnable the log of found labeled disk. Usefull for initial configuration.
Configure the mount in media pathEnable the visibility of moredisk on /media path.
Enable recyle_bin on shareAllow client SO to use Recycle Bin functionality on share
Enable the use of external WSDD daemonSetting this option to true will enable the use of wsdd over internal samba system.
Enable the use of Netgear WSDD daemonSetting this option to true will enable the use of wsdd2 over wsdd. Set to true if you have trouble to see the disk on Windows 11+