jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-09 18:36:51 +00:00
Code Issues Packages Projects Releases Wiki Activity

Installing Samba add-on: rephrase to use a more procedural style (#32909)

Browse Source 
* Installing Samba add-on: rephrase to make more procedural

* Fix copy paste error

* Update source/_includes/common-tasks/file_access.md

Co-authored-by: Joakim Sørensen <joasoe@gmail.com>

* Add example hostname

* Update source/_includes/common-tasks/file_access.md

Co-authored-by: Joakim Sørensen <joasoe@gmail.com>

---------

Co-authored-by: Joakim Sørensen <joasoe@gmail.com>
This commit is contained in:
c0ffeeca7 2024-05-23 14:04:14 +02:00 committed by GitHub
parent fd2c344011
commit 5e31c70a28
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 22 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
source/_includes/common-tasks/file_access.md
View File

@ -19,19 +19,34 @@ Using any of the add-ons listed below, the following directories are made availa
The Samba add-on creates smb shares which can be accessed from another computer. You can also edit files using the editor of your preference from your client computer. This add-on can be installed from the add-on store's official repository.
To configure the Samba add-on, you only need to set a user and password of your choice on the configuration page, save, and then start the add-on. The add-on will not start without setting a password!
To install the add-on, follow these steps:
To connect to the Samba server from another device, you will use the IP address or hostname of your server. Either of these can be found on the {% my network title="Settings > System > Network" %} page of your UI.
1. Go to {% my supervisor_addon title="**Settings** > **Add-ons** > **Samba share**" addon="core_samba" %} and select **Install**.
2. On the **Configuration** tab, define **Username** and **Password**, store them in a safe place, and save your changes.
- You can specify any username and password.
- They are not related to the login credentials you use to log in to Home Assistant or to log in to the computer with which you will use Samba share.
- The add-on won't start if user name and password are not defined.
3. For further configuration information, refer to the **Documentation** tab.
4. To start the add-on, on the **Information** tab, select **Start**.
For connecting from Windows 10, you can enter the IP address or hostname in File Explorer's address bar with two backslashes, as shown in the example screenshot.
To connect to the Samba server from the other device, follow these steps:
<img src='/images/hassio/screenshots/file_explorer.png' />
1. Go to {% my network title="**Settings** > **System** > **Network**" %} and take note of the **Host name**.
- Alternatively, you can look up the host name or IP address of your Home Assistant on your router.
2. How you connect from another device to Home Assistant depends on your system. Use one of the following options:
- **On Windows**: Open **File Explorer** and in the address bar, enter the IP address or hostname with two backslashes as `\\your.ha.ip.address` or `\\hostname`.
You should then be prompted for the credentials you entered in the Samba add-on configuration. You also have the option of having the credentials stored so that you do not need to enter them again. After that, you'll have access to the directories which you can then mount as a drive or pin to Quick Access.
<p class='img'>
<img src='/images/hassio/screenshots/file_explorer.png' alt='Screenshot of File Explorer displaying the navigation to a file share using an IP address'>
Screenshot of File Explorer displaying the navigation to a file share using an IP address
</p>
- **On OS X**: Open **Finder** and select **Go** > **Connect to Server...** and enter the IP address or hostname as `smb://your.ha.ip.address` or `smb://hostname`.
- **On Ubuntu**: Open **Nautilus** and in the address bar, enter the IP address or hostname as `smb://your.ha.ip.address` or `smb://hostname`.
For OS X, connecting to the shares is a matter of using the Finder menu > Go > Connect to Server...
You would then enter the IP address or hostname of your Home Assistant OS instance as `smb://your.ha.ip.address` or `smb://homeassistant` and enter your credentials when prompted.
3. Enter the credentials you entered in the Samba add-on configuration.
- You also have the option of having the credentials stored so that you do not need to enter them again.
4. Done! You now have access to the directories which you can then mount as a drive or pin to Quick Access.
---