📘 Blueprint Update Notifications

FAQ - How to set up Folder Watcher

What is the Folder Watcher integration?

The Folder Watcher integration in Home Assistant monitors specified folders for changes like file creation, modification, deletion, or movement. When a change happens, it triggers events that you can use to start automations.


Why should I use Folder Watcher?

Folder Watcher helps you automatically detect updates to your blueprint files. When a blueprint file changes, Folder Watcher triggers automations that update your sensors, keeping them in sync with the latest blueprint version.


Do I need to use Folder Watcher?

No, the local version sensor will still update when Home Assistant restarts, when its scan interval runs, or whenever the automation is triggered. This option is not required unless you want version changes reflected immediately in the UI when you update the blueprint.


How do I set up Folder Watcher?

For detailed installation instructions, please visit the official Home Assistant page: Folder Watcher Integration.

After installation, follow these two steps:

  1. Add the folder to the allowlist
    To prevent errors like “Configured path is not in allowlist”, add the following to your configuration.yaml:
homeassistant:
  allowlist_external_dirs:
    - /config/blueprints/automation/Blackshome/
  1. Configure Folder Watcher integration
  • Install the Folder Watcher integration from Home Assistant.
  • Add the folder path /config/blueprints/automation/Blackshome/ to monitor.
  • In your blueprint, enable the Folder Watcher option and enter the blueprint file name to watch (for example, sensor-light.yaml).

What if I use blueprints from other developers?

If you use blueprints from other developers stored in different folders, you will need to add those folders’ paths to the allowlist_external_dirs as well. For example:

homeassistant:
  allowlist_external_dirs:
    - /config/blueprints/automation/Blackshome/
    - /config/blueprints/automation/hvorragend/
    - /config/blueprints/automation/Blackymas/

You will also need to add each of these folders as additional entries in the Folder Watcher integration so it can monitor them properly.

Enjoy

Blacky :smiley:

Back to FAQ: Click Here