Nextcloud Integration

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 %}