How to Set Up Samba Share in Home Assistant (The Definitive 2026 Guide)

Last updated: March 25, 2026

In my experience, installing the Samba add-on is one of the first steps that transforms managing Home Assistant from a technical chore into a seamless, efficient experience. In 2026, as our smart homes grow more complex, having direct and easy access to configuration files is non-negotiable. With the Home Assistant Samba Share add-on, you can edit automations, manage backups, and add media files as if they were just another folder on your computer. In this definitive guide, we’ll break down the installation and configuration process step-by-step so you can master local network access to your Home Assistant files—quickly and securely.

What is Samba and Why Do You Need It in Home Assistant in 2026?

Samba is the open-source implementation of the SMB (Server Message Block) protocol, the battle-tested standard created by Microsoft for sharing files over a local network. Think of it as the universal language that allows your Windows PC, Mac, or Android phone to see and edit files hosted on another device—in this case, your Home Assistant instance. Its rock-solid reliability and universal compatibility have made it a standard feature in everything from routers and NAS drives (like Synology) to the very heart of our smart home hub.

For Home Assistant users, Samba means you can ditch clunky tools like SSH or the built-in File Editor for everyday tasks. You just open a network folder on your computer, enter a password, and you have full access to your Home Assistant directory structure. This is a game-changer for editing YAML files, managing snapshots you’ve created with the Google Drive integration, or uploading custom sound files for your notifications.

Guide to Installing and Configuring Home Assistant Samba Share

The process of enabling file access is incredibly straightforward, thanks to Home Assistant’s Add-ons system. You’ll be up and running in just a few minutes.

1. Install the “Samba share” Add-on

First, you need to install the official add-on. Follow this path in your Home Assistant interface:

1. Navigate to Settings > Add-ons.
2. In the bottom-right corner, click the blue Add-on Store button.
3. Use the search bar to find “Samba share“.
4. Select it and click the Install button. The process will take a moment.

2. Essential Configuration

Before starting the add-on, you need to configure it. Click on the Configuration tab within the Samba share page. Here you’ll find a small YAML text editor. I recommend the following basic configuration to get started:

workgroup: WORKGROUP
username: your_username
password: 'your_super_secret_password'
interface: ''
allow_hosts:
  - 192.168.1.0/24
veto_files:
  - ._*
  - .DS_Store
  - Thumbs.db
  - .Trashes
compatibility_mode: false

Let’s break down the most important keys:

• username: Pick a username you’ll remember for access.
• password: Critical! Use a strong, unique password. Do not reuse your Home Assistant password.
• allow_hosts: This defines which devices on your network can connect. The value 192.168.1.0/24 allows access from any device within the 192.168.1.X subnet. For enhanced security, adjust this to match your local network’s IP range. If you want to take your security to the next level, I highly recommend reading my guide on how to properly segment your home network.
• veto_files: This is a handy option to prevent temporary or junk system files (common on macOS and Windows) from cluttering your Home Assistant folders. It’s best to leave this as is.

Once you’ve edited the configuration, click Save. Now, go back to the Info tab and enable the “Start on boot” and “Watchdog” toggles. Finally, click Start.

Accessing Your Files & Practical Use Cases

With Samba up and running, you can now access your folders. The method varies slightly by operating system:

• On Windows: Open File Explorer and, in the address bar, type \\homeassistant.local or \\your_home_assistant_ip (e.g., \\192.168.1.100) and press Enter. It will prompt you for the username and password you configured.
• On macOS or Linux: Open your file manager (Finder on macOS) and look for an option like “Connect to Server”. Enter smb://homeassistant.local or smb://your_home_assistant_ip (e.g., smb://192.168.1.100).

Once connected, you’ll see a key folder structure. Here’s a breakdown of the most important ones and how I use them daily:

Common Troubleshooting and Alternatives

Although the setup is simple, issues can pop up. The most common one is an “access denied” error. This is almost always caused by a typo in the password or by your computer’s IP not being included in the `allow_hosts` list in the configuration. Double-check those two points and restart the add-on from the Home Assistant UI.

While Samba is my go-to for file management, there are other great alternatives in 2026:

• “Visual Studio Code” Add-on: This lets you edit all your configuration files directly from your web browser using a powerful code editor. It’s fantastic for writing YAML, but it isn’t designed for moving large files like videos or backups.
• SSH/SFTP Access: For the most technical users, the “Advanced SSH & Web Terminal” add-on provides deeper system access. It’s more complex but also significantly more powerful.

Conclusion: A Must-Have Tool for Any Power User

Ultimately, installing the Home Assistant Samba Share add-on in 2026 is a foundational step to streamlining your workflow and simplifying your smart home administration. The ability to manage configuration files, backups, and media natively from your computer will save you countless hours and let you focus on what really matters: building a smarter, more automated home.