You signed in with another tab or window.Reload to refresh your session.You signed out in another tab or window.Reload to refresh your session.You switched accounts on another tab or window.Reload to refresh your session.Dismiss alert
This apps provides useful server information, such as CPU load, RAM usage,disk usage, number of users, etc. Check out the providedExample XML outputfor the details.
The admin can look up this information directly in Nextcloud (Settings ->Management-> Information) or connect an external monitoring tool to theprovided end-points.
Installation
This app is part of the standard Nextcloud package and can be found in thedirectorynextcloud/apps/serverinfo
API
The API provides a lot of information about a running Nextcloudinstance in XML or JSON format by using the following URL.
To request the information in JSON append the url parameterformat=json
Use the url parameterskipUpdate=true to omit server updates.
Use the url parameterskipApps=true to omit app updates (including available app updates will send an external request to the app store).
Example XML output:
<?xml version="1.0"?><ocs><meta><status>ok</status><statuscode>200</statuscode><message>OK</message></meta><data><nextcloud><system><version>30.0.0.1</version><theme/><enable_avatars>yes</enable_avatars><enable_previews>yes</enable_previews><memcache.local>OC\Memcache\APCu</memcache.local><memcache.distributed>none</memcache.distributed><filelocking.enabled>yes</filelocking.enabled><memcache.locking>OC\Memcache\Redis</memcache.locking><debug>no</debug><freespace>48472801280</freespace><cpuload><element>1.81</element><element>1.39</element><element>1.24</element></cpuload><mem_total>8183664</mem_total><mem_free>5877568</mem_free><swap_total>0</swap_total><swap_free>0</swap_free><apps><!-- only with skipApps=false --><num_installed>53</num_installed><num_updates_available>1</num_updates_available><app_updates><files_antivirus>2.0.1</files_antivirus></app_updates></apps><update><!-- only with skipUpdate=false --><lastupdatedat>1719244666</lastupdatedat><available/></update></system><storage><num_users>7</num_users><num_files>708860</num_files><num_storages>125</num_storages><num_storages_local>7</num_storages_local><num_storages_home>7</num_storages_home><num_storages_other>111</num_storages_other></storage><shares><num_shares>1</num_shares><num_shares_user>0</num_shares_user><num_shares_groups>0</num_shares_groups><num_shares_link>0</num_shares_link><num_shares_link_no_password>0</num_shares_link_no_password><num_fed_shares_sent>0</num_fed_shares_sent><num_fed_shares_received>0</num_fed_shares_received><permissions_4_1>1</permissions_4_1></shares></nextcloud><server><webserver>Apache/2.4</webserver><php><version>7.2.14</version><memory_limit>536870912</memory_limit><max_execution_time>3600</max_execution_time><upload_max_filesize>535822336</upload_max_filesize></php><database><type>mysql</type><version>10.2.21</version><size>331382784</size></database></server><activeUsers><last5minutes>2</last5minutes><last1hour>4</last1hour><last24hours>5</last24hours></activeUsers></data></ocs>
Since collecting storage statistics might take time and cause slow downs, they are updated in the background. A background job runs once every three hours to update the number of storages and files. The interval can be overridden per app settings (the value is specified in seconds):
To obtain information about your server, the serverinfo app reads files outside the application directory (e.g. /proc on Linux) or executes shell commands (e.g. df on Linux).
If you don't want that (for example, to avoid open_basedir warnings) enable the restricted mode.