Nextcloud Integration (#11780)

* add nextcloud integration documentation

* Fix changes suggested by @frenck

* ✏️ Tweak

* add logo file

* Update sample configuration

* Update Home Assistant term

* ⬆️ ha_release 0.108

Co-authored-by: Klaas Schoute <klaas_schoute@hotmail.com>
Co-authored-by: Franck Nijhof <frenck@frenck.nl>
This commit is contained in:
MeIchthys 2020-03-24 11:13:37 -04:00 committed by GitHub
parent 8a8c7d3725
commit 1cdd2f2f97
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 45 additions and 0 deletions

View File

@ -0,0 +1,45 @@
---
title: Nextcloud Sensor
description: Instructions on how to integrate Nextcloud monitor api data into Home Assistant.
logo: nextcloud.png
ha_category:
- Sensor
ha_iot_class: Cloud Polling
ha_release: 0.108
---
The `nextcloud` integration pulls summary [Nextcloud](https://nextcloud.com/) information into Home Assistant.
![Nextcloud Example Sensor]('/images/screenshots/nextcloud-sample-sensor.png')
## Configuration
This integration requires access to the monitor API of a Nextcloud instance (This is generally an admin user).
You should also generate an App password from the Nextcloud web UI: **Settings** > **Security** > **Devices & sessions** > **Create new app password**.
Once you have generated the App password, add the following to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
nextcloud:
url: Https://YOUR_NEXTCLOUD_URL
username: YOUR_USERNAME
password: YOUR_APP_PASSWORD
```
{% configuration %}
url:
description: The full URL to your Nextcloud instance.
required: true
type: string
username:
description: The username of a Nextcloud user that has access to the Nextcloud monitor API.
required: true
type: string
password:
description: The app password generated from the Nextcloud security settings page.
required: true
type: string
{% endconfiguration %}

Binary file not shown.

After

Width:  |  Height:  |  Size: 28 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 52 KiB