Skip to main content

Synology DiskStation

NASHardware

Monitor CPU, memory, storage volumes, and system health from Synology DSM.

Widgets & Capabilities​

System Health MonitoringDisplays information showing the health and status of your system(s).
Details
System ResourcesDisplays CPU, RAM and network of your host
Details
System disksDisk usage of your system
Details

Supported metrics​

Widget sectionDSM API sourceMay be unavailable
CPU ring / chartSYNO.Core.System.Utilization—
Memory ring / chartSYNO.Core.System.Utilization—
CPU temperature ringSYNO.Core.System system infoModels without a temperature sensor
Network chartsSYNO.Core.System.Utilization network totalsSome DSM builds or permission configurations
Load average (info modal)SYNO.Core.System.Utilization CPU load fields—
Storage volume usageSYNO.Core.System storage info / Storage Manager API—
SMART status and temperatureStorage Manager and SMART APIsDisk-to-volume mapping may be incomplete on some setups
Reboot / update indicatorSYNO.Core.System.Status / upgrade APIsPermission-dependent
GPUNot availableTypical DiskStation models

Adding the integration​

You can find how to add the integration on the Integrations Management documentation page.

Use the correct DSM URL

Enter the HTTP or HTTPS URL of your Synology DSM web interface, for example http://diskstation.local:5000 or https://diskstation.local:5001. If DSM uses a self-signed certificate, add it under Management > Tools > Certificates so Homarr can connect securely.

Secrets​

NameDescription
Username
Account username for authentication.
Password
Account password for authentication.
Administrators group required
Homarr reads system, storage, and utilization data from APIs that require membership in the default Administrators group.
Two-factor authentication is not supported
Accounts with 2-step verification enabled cannot authenticate with this integration. Use a dedicated service account without 2FA.
First-time setup
If login fails during testing, temporarily disable automatic blocking for invalid logins under Control Panel > Security > Protection, then re-enable it after Homarr connects successfully.

Steps to retrieve the credentials:

  1. Create a dedicated DSM user with a strong password for Homarr.
  2. Add the user to the default Administrators group so Homarr can read `SYNO.Core.System` metrics.
  3. Under User Groups and Permissions, deny access to shared folders and most applications.
  4. Allow login to DSM only, optionally restricted by source IP address.
  5. Log in once with the service account in DSM to accept terms and conditions.

Storage volume selection​

Health Monitoring and System Disks widgets can filter Synology storage volumes when every selected integration is a Synology DiskStation. Leave Visible storage volumes empty to show all volumes, or pick specific volumes from the list. When multiple Synology integrations are connected, volumes are labeled with the integration name.

Synology-only option

The volume filter is hidden when the widget also uses non-Synology integrations such as TrueNAS or Unraid.

Volume ordering

When no volume filter is configured, the first volume returned by DSM is not guaranteed to be volume_1.