Files
addons/samba
Franck Nijhof 2f80548b72 Re-branding of core add-ons (#1046)
* Re-branding of core add-ons

* Update title README

* Fix ada description

Co-Authored-By: Paulus Schoutsen <balloob@gmail.com>

Co-authored-by: Paulus Schoutsen <paulus@home-assistant.io>
2020-02-04 21:38:55 +01:00
..
2018-03-23 23:59:49 +01:00
2020-02-04 21:38:55 +01:00

Home Assistant Add-on: Samba share

Share your configuration over the network using Windows file sharing.

Supports aarch64 Architecture Supports amd64 Architecture Supports armhf Architecture Supports armv7 Architecture Supports i386 Architecture

About

This Add-on allows you to enable file sharing across different operating systems over a network. It lets you access your config files with Windows and macOS devices.

Installation

Follow these steps to get the add-on installed on your system:

  1. Navigate in your Home Assistant frontend to Hass.io -> Add-on Store.
  2. Find the "Samba share" add-on and click it.
  3. Click on the "INSTALL" button.

How to use

  1. In the configuration section, set a username and password.
  2. Save the configuration.
  3. Start the add-on.
  4. Check the add-on log output to see the result.

Configuration

Add-on configuration:

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

Option: workgroup (required)

Change WORKGROUP to reflect your network needs.

Option: username (required)

The username you would like to use to authenticate with the Samba server.

Option: password (required)

The password that goes with the username configured for authentication.

Option: interface (required)

The network interface Samba should listen on for incoming connections. This option should only be used in advanced cases. In general, setting this option is not needed.

Option: allow_hosts (required)

List of hosts/networks allowed to access the shared folders.

Option: veto_files (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 or Windows Thumbs.db files)

Support

Got questions?

You have several options to get them answered:

In case you've found a bug, please open an issue on our GitHub.