Synology UPS Tips and Tricks
Recently, I replaced the Uninterruptible Power Supply (UPS) connected to my Synology with an APC BX2200MI. During setup, I ran into some typical Synology shenanigans, which I managed to work around. I documented them here for anyone else who might encounter the same issues (and as a note to my future self).
Add More Than Five ‘Permitted DiskStation Devices’ (a.k.a. NUT Clients)
If you have multiple devices connected to your UPS that you’d like to shut down safely in the event of a power outage, your Synology can act as a ‘network UPS server.’ Under the hood, Synology runs Network UPS Tools (NUT), an open-source UPS monitoring tool. NUT works with thousands of UPS devices and on many operating systems. You’re therefore not limited to connecting only Synology appliances to your UPS; any machine that supports NUT can be shut down safely.
In my case, I’ve also connected a couple of servers, as the UPS has enough capacity for them. However, you need to allowlist (i.e., permit) the IP address of each “NUT client” that’s allowed to retrieve the UPS status from your Synology. Unfortunately, the Synology DSM web interface limits the number of “Permitted DiskStation Devices” to five, but this is an arbitrary Synology limit, not a NUT limit.
If you need to allowlist more than five NUT clients, you can do so by logging in to your Synology via SSH and editing the following file as root:
/usr/syno/etc/ups/synoups.conf
Add the IP addresses in the same format as the first five entries. The Synology web interface will still only display the first five, but additional clients will work just fine! Note: Changing any UPS setting in the Synology web interface will overwrite the file and remove your extra IPs, so try to avoid making further changes there.
Don’t forget to restart the NUT UPS daemon to apply your changes:
sudo synosystemctl restart ups-usb
Pro tip: The default NUT username on Synology is monuser with the password secret. If you need more information on configuring a non-Synology NUT client, take a look at this gist: https://gist.github.com/jhelmink/ba54e11e6a1b9f448a4a9a5c4cb45b89
Change UPS Parameters
By default, most UPS units come with parameters defining what qualifies as “low battery.” For my specific APC UPS, it is set so that 10% battery charge or 120 seconds of runtime remaining will trigger a “low battery” status, which in turn signals the Synology (by default) to shut down cleanly to prevent data loss. You can see these values by running:
upsc ups@localhost
(from an SSH session on your Synology).
I wanted to adjust these parameters. My main reason for owning a UPS is to protect data rather than maintain uptime during an outage. Ten percent battery charge (or just two minutes) before initiating shutdown seems too tight because it takes my Synology some time to stop all processes, spin down disks, and power off safely. Also, if power returns, causing the Synology to reboot, and then goes out again, I want enough runtime left for another clean shutdown.
If you have only one or more Synology devices connected to your UPS and no additional (vanilla) NUT clients, you can skip the steps below and simply use the Customize time option built-in Synology DSM. Keep in mind, however, that this setting is client-side. If you do have other NUT clients, you’d need to configure each client individually, which can be more work than ticking a single box in DSM. Therefore, if you plan to shut down multiple devices after running on battery for a certain number of minutes, I recommend updating these parameters directly in the UPS firmware. That way, if you unplug the UPS and connect it to another system in the future, the configured value will remain in the UPS itself.
To modify these parameters in the UPS firmware, you could use the official tooling—PowerChute for APC devices—but that means unplugging the UPS from your Synology and connecting it to a Windows PC. However, because Synology uses NUT under the hood, we can also use NUT’s upsrw command to do this remotely. The catch is that Synology’s firmware omits upsrw, so you’ll need a separate Linux machine that does have upsrw in order to connect to your Synology’s NUT server and change the UPS parameters.
Adding a NUT Admin User
Synology hardcodes a single NUT user (monuser) and does not provide an admin account by default. To change firmware parameters, though, you’ll need a NUT admin user. To create one, log in to your Synology over SSH as root and edit:
/etc/ups/upsd.users
Add the following section at the bottom:
[admin]
password = YourNewPassword
actions = SET
instcmds = ALL
Then restart the NUT service:
sudo synosystemctl restart ups-usb
Changing the UPS Parameters
From your Linux machine (the one with upsrw installed), first check which UPS parameters are configurable:
upsrw ups@<YOUR_SYNOLOGY_IP>
You might see something like this:
[battery.charge.low]
Description unavailable
Type: STRING
Maximum length: 10
Value: 10
[battery.runtime.low]
Description unavailable
Type: STRING
Maximum length: 10
Value: 120
[input.sensitivity]
Description unavailable
Type: STRING
Maximum length: 10
Value: medium
...To change, for example, battery.runtime.low to 300 (i.e., the UPS will trigger a shutdown at 300 seconds of remaining runtime):
upsrw -s battery.runtime.low=300 -u admin -p YourNewPassword ups@<YOUR_SYNOLOGY_IP>
This sets the value in the UPS firmware, so the setting persists even if you later move the UPS to another system.
Once you’re done making changes, remember to restart NUT on your Synology:
sudo synosystemctl restart ups-usb
If you no longer need the admin account, simply remove the section you added to /etc/ups/upsd.users and restart NUT again.
Double-Check UPS Compatibility
This may be obvious, but always verify that your UPS is compatible with your specific Synology model. In my case, I have two NAS units: a DS918+ and a DS218Play. Initially, I plugged the UPS into the DS918+. Although it seemed fine at first—values were read correctly—the Synology soon started reporting that the UPS was constantly going offline and back online with no clear cause. Replugging the USB cable and rebooting didn’t help.

After consulting the Synology Compatibility List, I noticed the DS918+ isn’t listed for my UPS model, but the DS218Play is. Sure enough, once I plugged the UPS into the DS218Play, the random off/online flapping immediately stopped.














































