For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /home-assistant/integrations/nextcloud.md.

    Nextcloud

    The Nextcloud integration pulls summary Nextcloud information into Home Assistant.

    该集成为内置 Nextcloud serverinfo 应用程序 提供的大多数数据点提供传感器和二进制传感器。

    要查看您的 nextcloud 实例公开了哪些数据点，请浏览到以下 URL：“https://<your_nextcloud_url>/ocs/v2.php/apps/serverinfo/api/v1/info?format=json&skipUpdate=false”。

    Nextcloud 示例传感器

    Configuration

    此集成具有以下 Nextcloud Server 先决条件：

    • 用户必须属于 Nextcloud admin 组 (Nextcloud > Users)
    • 必须安装 Nextcloud“监控”应用程序（Nextcloud > 应用程序 > 🔍（搜索图标）> 监控 > 启用）
    • （推荐）应生成 Nextcloud 应用程序密码以在 Home Assistant 中使用（Nextcloud > 设置 > 个人 > 安全 > 设备和会话 > 创建新应用程序密码）

    Configuration

    To add the Nextcloud service to your Home Assistant instance, use this My button:

    Open Add integration in your Home Assistant instance.

    Manual configuration steps

    Sensors

    For each entry, the integration will create the following sensors:

    SensorEnabled by default
    Amount of active users last 5 minutes✅
    Amount of active users last day✅
    Amount of active users last hour✅
    Amount of files✅
    Amount of group shares✅
    Amount of link shares✅
    Amount of local storages✅
    Amount of mail shares✅
    Amount of other storages✅
    Amount of passwordless link shares✅
    Amount of room shares✅
    Amount of shares✅
    Amount of shares received✅
    Amount of shares sent✅
    Amount of storages✅
    Amount of storages at home✅
    Amount of user✅
    Amount of user shares✅
    Apps installed✅
    Avatars enabled✅
    CPU load last 1 minute✅
    CPU load last 15 minutes✅
    CPU load last 5 minutes✅
    Cache TTL❌
    Cache expunges❌
    Cache memory❌
    Cache memory size✅
    Cache number of entries❌
    Cache number of hits❌
    Cache number of inserts❌
    Cache number of misses❌
    Cache number of slots❌
    Cache start time❌
    Database size✅
    Database type✅
    Database version✅
    Debug enabled✅
    Filelocking enabled✅
    Free memory✅
    Free space✅
    Free swap memory✅
    Interned buffer size❌
    Interned free memory❌
    Interned number of strings❌
    Interned used memory❌
    JIT active❌
    JIT buffer free❌
    JIT buffer size❌
    JIT enabled❌
    JIT kind❌
    JIT opt flags❌
    JIT opt level❌
    Opcache blacklist miss ratio❌
    Opcache blacklist misses❌
    Opcache cached keys❌
    Opcache cached scripts❌
    Opcache current wasted percentage❌
    Opcache free memory❌
    Opcache hash restarts❌
    Opcache hit rate❌
    Opcache hits❌
    Opcache last restart time❌
    Opcache manual restarts❌
    Opcache max cached keys❌
    Opcache misses❌
    Opcache out of memory restarts❌
    Opcache start time❌
    Opcache used memory❌
    Opcache wasted memory❌
    PHP max execution time✅
    PHP memory limit✅
    PHP upload maximum filesize✅
    PHP version✅
    Previews enabled✅
    SMA available memory❌
    SMA number of segments❌
    SMA segment size❌
    System memcache distributed❌
    System memcache local❌
    System memcache locking❌
    System theme✅
    System version✅
    Total memory✅
    Total swap memory✅
    Updates available✅
    Webserver✅

    Update entity

    An update entity will be created for each entry.