Peanut

How to Connect PeaNUT (CasaOS) to a Synology UPS

Monitoring your power infrastructure is an excellent way to protect your data. If your uninterruptible power supply (UPS) is already connected to your Synology NAS via USB, you can use the NAS as a Network UPS Tools (NUT) server. This setup allows the PeaNUT container running on your CasaOS machine to pull live metrics like battery level, current load, and remaining runtime.

Step 1: Configure the Synology NAS (The Server)

First, we need to configure the Synology NAS to broadcast its UPS data on your local network so that CasaOS can read it.

  1. Log in to your Synology DSM.
  2. Navigate to Control Panel > Hardware & Power > UPS.
  3. Ensure Enable UPS support is checked (it should be if the UPS is already recognized).
  4. Check the box for Enable network UPS server.
  5. Click the Permitted DiskStation Devices button.
  6. In the pop-up window, enter the IP Address of your CasaOS machine. This step specifically grants PeaNUT permission to access the UPS data.
  7. Click OK, and then click Apply to save the settings.

Step 2: Connect PeaNUT in CasaOS (The Client)

Synology uses a strict, hardcoded set of default credentials for its internal NUT server. When you open your PeaNUT dashboard to add the UPS connection, you must use these exact details.

Host / IP Address: [The IP Address of your Synology NAS]
Port: 3493
UPS Name: ups
Username: monuser
Password: secret
Note: monuser and secret are the permanent default credentials Synology uses for its network UPS server. The UPS name is also defaulted to ups.

Once you enter those details and hit save, PeaNUT will connect to the Synology NAS and begin populating your dashboard with live data.