diff --git a/source/_integrations/nextcloud.markdown b/source/_integrations/nextcloud.markdown new file mode 100644 index 00000000000..e873376875a --- /dev/null +++ b/source/_integrations/nextcloud.markdown @@ -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 %} diff --git a/source/images/screenshots/nextcloud-sample-sensor.png b/source/images/screenshots/nextcloud-sample-sensor.png new file mode 100644 index 00000000000..dcb30a000a4 Binary files /dev/null and b/source/images/screenshots/nextcloud-sample-sensor.png differ diff --git a/source/images/supported_brands/nextcloud.png b/source/images/supported_brands/nextcloud.png new file mode 100644 index 00000000000..1c9558a1301 Binary files /dev/null and b/source/images/supported_brands/nextcloud.png differ