Home Assistant Home Assistant
Edit this page on GitHub

Nextcloud

The nextcloud integration pulls summary Nextcloud information into Home Assistant.

Nextcloud Example Sensor

Configuration

This integration has the following Nextcloud Server prerequisites:

  • The user must be in the Nextcloud admin group (Nextcloud > Users)
  • The Nextcloud ‘Monitoring’ app must be installed (Nextcloud > Apps > 🔍(Search Icon) > Monitoring > Enable)
  • (Recommended) A Nextcloud App password should be generated for use in Home Assistant (Nextcloud > Settings > Personal > Security > Devices & sessions > Create new app password)

To enable the Nextcloud integration, add the following lines to your configuration.yaml:

# Example configuration.yaml entry
nextcloud:
  url: https://YOUR_NEXTCLOUD_URL
  username: YOUR_USERNAME
  password: YOUR_APP_PASSWORD

Configuration Variables

urlstringRequired

The full URL to your Nextcloud instance.

usernamestringRequired

The username of a Nextcloud user that has access to the Nextcloud monitor API.

passwordstringRequired

The app password generated from the Nextcloud security settings page.