Samba


This add-on allows you to set up a Samba server to access Hass.io folders using Windows network shares.

Be careful when setting up port forwarding for remote access. If you don’t restrict access by setting a username and strong password, your configuration could be exposed to the entire Internet!

Sometimes shares will not show up under network in Windows. Then you could open the file browser, click the address field where it says “> Network” and type //HASSIO to access Hass.io shares.

{
  "workgroup": "WORKGROUP",
  "username": "",
  "password": "",
  "interface": "eth0",
  "allow_hosts": [
      "10.0.0.0/8",
      "172.16.0.0/12",
      "192.168.0.0/16"
  ],
  "veto_files": [
      "._*",
      ".DS_Store",
      "Thumbs.db",
      "icon?",
      ".Trashes"
  ]
}

Configuration Variables

workgroup

(string)(Optional)

Set network workgroup name.

Default value:

WORKGROUP

username

(string)(Required)

Username for logging in.

password

(string)(Required)

Password for username. An empty password is not supported.

interface

(string)(Optional)

Interface that will start the share. Normally this is eth0 for ethernet wired connection and wlan0 for wireless connection. If you are running on an Intel NUC this could also be enp3s0 for ethernet or wlp5s0 for wireless connection.

allow_hosts

(list)(Optional)

The hosts that are allowed to connect to your Samba server. By default it is limited to people within the same local network.

Default value:

["10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16"]

veto_files

(list)(Optional)

List of files that are neither visible nor accessible. Useful to stop clients from littering the share with temporary hidden files (e.g. macOS .DS_Store, Windows Thumbs.db)

Default value:

["._*", ".DS_Store", "Thumbs.db", "icon?", ".Trashes"]