--- layout: page title: "Samba" description: "Manage your Home Assistant and custom add-ons over Samba." date: 2017-04-30 13:28 sidebar: true comments: false sharing: true footer: true featured: true --- This add-on allows you to set up a [Samba](https://samba.org/) 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!

```json { "workgroup": "WORKGROUP", "username": "", "password": "", "interface": "eth0", "allow_hosts": [ "10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16" ] } ``` {% configuration %} workgroup: description: Set network workgroup name. required: false default: "`WORKGROUP`" type: string username: description: Username for logging in if guest login is not used. required: true type: string password: description: Password for `username`. An empty password is not supported. required: true type: string interface: description: 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. required: false type: string allow_hosts: description: The hosts that are allowed to connect to your Samba server. By default it is limited to people within the same local network. required: false default: '`["10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16"]`' type: list {% endconfiguration %}