Guides

How to check a UPS battery on a Mac

Where macOS shows the battery level of a UPS connected by USB, how to set when the Mac shuts down, the Terminal commands, and what macOS does not tell you.

Updated

macOS supports a UPS that connects by USB, with no extra software. When it finds one, it shows the battery level of the UPS in the menu bar and in the Energy settings, and it can shut the Mac down before the UPS is empty. Here is each place, and what is missing.

The menu bar

On a desktop Mac, a battery icon appears in the menu bar when macOS finds the UPS. An iMac, a Mac mini or a Mac Studio has no battery of its own, so this icon is the UPS.

  1. Connect the data cable of the UPS to a USB port on the Mac.
  2. Click the battery icon in the menu bar.
  3. Read the battery level of the UPS.

The Energy settings

  1. Open the Apple menu and choose System Settings.
  2. Click Energy in the sidebar.
  3. Read the UPS level. Scroll down if you do not see it.

On a MacBook, people report that the UPS level is in the Battery settings and in the battery menu.

Set when the Mac shuts down

A UPS gives you minutes, not hours. macOS can shut the Mac down by itself, so that an outage while you are away does not end with a hard power cut.

  1. Open the Apple menu and choose System Settings.
  2. Click Energy, then click UPS Options.
  3. Select one or more options, and move each slider to the time or the battery level you want.
  4. Click Done.

The options shut the Mac down after a time on the UPS battery, at a time remaining, or below a battery level. If you select more than one, the Mac shuts down at the first one that is reached.

When the power fails, the UPS beeps and macOS shows one warning that the Mac is running on UPS power.

Terminal

Open Terminal and type one of these commands.

Command What it shows or does
pmset -g batt The power sources, with the level of the UPS and if it is on AC power
pmset -g ups The shutdown settings for the UPS
pmset -g pslog A running log of power source changes
sudo pmset -u haltlevel 25 Shuts the Mac down when the UPS battery drops to 25%
sudo pmset -u haltafter 5 Shuts the Mac down after 5 minutes on the UPS battery
sudo pmset -u haltremain 10 Shuts the Mac down when 10 minutes remain

UPS not showing on a Mac

If there is no battery icon and no UPS Options button, macOS has not found the UPS.

  1. Check the cable. The UPS needs its USB data cable to the Mac, not only its power cable. Some APC units use their own data cable, and people report that a different cable does not work.
  2. Connect the cable to the Mac directly, not through a hub.
  3. Hold the Option key, open the Apple menu and choose System Information. Click USB, then Power. A UPS that macOS has found is in both lists.
  4. Restart the Mac with the UPS connected.

What macOS does not show

A lead-acid UPS battery lasts about 3 to 5 years. APC advises replacement after 3 to 4 years, or when the UPS shows its replace battery light.

CyberPower’s PowerPanel Personal for Mac adds event logs, notifications and scheduled shutdown for CyberPower units. APC’s PowerChute Personal Edition is for Windows, so an APC unit on a Mac uses the built-in support.

Keep the UPS in the menu bar

BatteryBud is a battery monitor for Mac. From version 1.2.0 it shows a UPS that is connected by USB. The UPS gets its own Power group in the list, next to your other batteries.

The usual low battery alert works for it. Set a level, for example 50%, and BatteryBud tells you when the UPS is running down. You can also pin the UPS to the menu bar with its percentage, which helps on a MacBook, where the menu bar shows only the MacBook’s own battery.

BatteryBud reads batteries and does not control them. Keep the shutdown settings in macOS, with the steps above.

Questions

Where are the UPS settings on a Mac?

On a desktop Mac, open the Apple menu, choose System Settings, click Energy, and click UPS Options. The button is there only while macOS detects a UPS.

Why is there no UPS Options button on my Mac?

macOS has not found the UPS. Check that the USB data cable is connected, and use the cable that came with the UPS. Then open System Information and look under USB and under Power.

Does a MacBook show UPS settings?

People report that a MacBook shows the UPS level in its Battery settings and its battery menu, with no UPS Options. Apple's steps are for a desktop Mac.

Do I need APC or CyberPower software on a Mac?

No. macOS supports a USB UPS by itself. APC's PowerChute Personal Edition is for Windows. CyberPower has PowerPanel Personal for Mac, which adds event logs, notifications and scheduled shutdown.

Does macOS tell me when the UPS battery needs replacement?

No. macOS shows the charge level, and not the condition of the battery. Use the light or the alarm on the UPS, and its self-test.

How long does a UPS battery last?

About 3 to 5 years for the lead-acid battery in most home units. APC advises replacement after 3 to 4 years, or when the UPS shows its replace battery light.

Can I set UPS shutdown from Terminal?

Yes. For example, sudo pmset -u haltlevel 25 shuts the Mac down when the UPS battery drops to 25%. The other settings are haltafter and haltremain, in minutes.

Keep reading