2022-03-30 21:50:39 +02:00

39 lines
1.2 KiB
Markdown

---
title: Syncthing
description: Instructions on how to integrate Syncthing within Home Assistant.
ha_category:
- Downloading
- Sensor
ha_release: 2021.6
ha_iot_class: Local Polling
ha_quality_scale: silver
ha_config_flow: true
ha_codeowners:
- '@zhulik'
ha_domain: syncthing
ha_platforms:
- sensor
ha_integration_type: integration
---
[Syncthing](https://syncthing.net/) is a continuous file synchronization program. It synchronizes files between two or more computers
in real-time, safely protected from prying eyes.
The Syncthing integration allows you to monitor states of your synced folders from within Home Assistant and set up automations based on the information.
## Prerequisites
To set up the monitoring you need to get an **API key**. Open the Syncthing web
interface(e.g., `http://127.0.0.1:8384`) in the browser and go to **Actions** -> **Settings**. You will find
the key on the right of the settings dialog.
{% include integrations/config_flow.md %}
## Integration Entities
The Syncthing integration adds one sensor per syncing folder:
![Syncthing Sensors](/images/integrations/syncthing/sensors.png)
![Syncthing Sensors](/images/integrations/syncthing/sensor.png)