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-05-16 16:08:58 +00:00
Code Issues Packages Projects Releases Wiki Activity
home-assistant.io/source/_includes/common-tasks/network_storage.md
Franck Nijhof ca962cf860
Enforce Markdown ordered list numbering (#28179)
2023-07-11 21:28:37 +02:00

4.4 KiB
Raw Blame History

Network storage

You can configure both Network File Share (NFS) and Windows samba (CIFS) targets to be used within Home Assistant and add-ons. To list all your currently connected network storages, go to {% my storage title="Settings > System > Storage" %} in the UI.

{% if page.installation == "os" %}

You need to update to Home Assistant Operating System 10.2 before you can use this feature.

{% else %}

You need to make sure you run a supported Home Assistant Supervised installation with the latest version of the os-agent. Make sure that your supervisor uses slave bind propagation for the data volume.

{% endif %}

Screenshot of the list of network shares inside the storage panel.

Add a new network storage

  1. Go to {% my storage title="Settings > System > Storage" %} in the UI.
  2. Select Add network storage.
  3. Fill out all the information for your network storage.
  4. Select Connect.

Screenshot of connecting a new network storage.

Network storage configuration

{% configuration_basic "hassio.network_share" %} Name: description: This is the name that will be used for the mounted directory on your system. Usage: description: Here, you select how the target should be used. See usage types below Server: description: The IP/hostname of the server running NFS/CIFS. "Protocol3": description: The service the server is using for the network storage. "[NFS]1 Remote share path": description: The path used to connect to the remote storage server. "[CIFS]2 Username": description: The username to use when connecting to the storage server. "[CIFS]2 Password": description: The password to use when connecting to the storage server. "[CIFS]2 Share": description: The share to connect to on the storage server. {% endconfiguration_basic %}

1 Options prefixed with [NFS] are only available for NFS targets.
2 Options prefixed with [CIFS] are only available for CIFS targets.
3 For the CIFS option, only version 2.1+ is supported.

Usage types

{% configuration_basic "hassio.network_share.usage" %} Backup: description: This will become a target. You can use it in service calls or when manually creating a backup. The first storage you add of this type becomes your new default target. If you want to change the default target, check out the documentation below. Media: description: A new directory with the name you gave your network storage will be created under /media. This directory can be accessed by Home Assistant and add-ons. Share: description: A new directory with the name you gave your network storage will be created under /share. This directory can be accessed by Home Assistant and add-ons. {% endconfiguration_basic %}

Change default backup location

By default, the first network storage of type Backup that you add will be set as your default backup target.

If you want to change the default backup target, you can do the following:

  1. Go to {% my backup title="Settings > System > Backups" %} in the UI.
  2. Select the menu in the top right of the screen and select the Change default backup location option.
  3. In the dialog, there is a single option to set the default backup target.
  4. Choose the one you want from the list.
  5. Select Save.

This list will contain all the network storage targets you have added of usage type Backup. It also contains another option to set it back to use /backup again.

Screenshot of changing the default backup target.