ONEAC(8)

✨ ONEAC — the oneac driver, explained by your fav Unix bestie ✨

okay so this is the manual page for oneac, the driver for Oneac UPS equipment. it lives in the NUT Manual (that's section 8, system administration, iykyk 💅). sit down, grab a strawberry, and let's get into it 🍓

---

🌸 NAME 🌸

oneac — the driver for Oneac UPS equipment. literally that's the whole name, no notes, periodt.

---

🎀 SYNOPSIS 🎀

oneac -h

oneac -a UPS_NAME [OPTIONS]

note, bestie — this man page only documents the hardware-specific features of the oneac driver. for the tea on the core driver, go read nutupsdrv(8). 🫶

---

👑 SUPPORTED HARDWARE 👑

this driver is compatible with various Oneac UPS families. the lineup:

• EG — late 80s, early 90s, plug-in serial interface card. vintage. iconic.
• ON — early and mid-90s, plug-in serial interface card.
• OZ — mid-90s on, DB-25 std., interface slot.
• OB — early 2000's on, big cabinet, DB-25 std., interface slot. big cabinet energy fr fr.

if your UPS is equipped with the Basic Interface card, bestie, you gotta use the genericups(8) driver instead. no cap.

---

💖 EXTRA ARGUMENTS 💖

this driver supports these optional settings in the ups.conf(5) file:

• testtime=num — change the battery test time from the 2 minute default. ✨
• offdelay=num — change the shutdown delay time from the 0 second default. ✨

---

🔥 INSTANT COMMANDS 🔥

this driver supports the following Instant Commands. (peep upscmd(8) if you need the deets.)

💅 All UPS units

• shutdown.return — turn off the load, possibly after a delay, and return when power is back.
• shutdown.stop — stop a shutdown that's in progress.
• shutdown.reboot — shut down the load briefly while rebooting the UPS.
• test.failure.start — starts a 15 second long simulation of an input power failure.
• test.battery.start.quick — start a "quick" battery test. the default time is 2 minutes, and you can set that time in the ups.conf file. see testime above.
• test.battery.stop — stops a battery test that is in progress.

🦋 All ON UPS units

• reset.input.minmax — reset the minimum and maximum input line voltage values seen since the last reset or power on.

🌈 Newer ON UPS units

• test.panel.start — start testing the UPS panel.
• test.battery.start.deep — start a "deep" battery test. this test runs the UPS until the low battery point and then returns to the AC line.
• reset.input.minmax — reset the minimum and maximum input line voltage values seen since the last reset or power on.
• beeper.enable — enable UPS beeper/buzzer.
• beeper.disable — disable UPS beeper/buzzer.
• beeper.mute — mutes the UPS beeper/buzzer for the current alarm condition(s).

---

⭐ WRITABLE VARIABLES ⭐

check out upsrw(8) to see what variables are writable for your UPS. 👀

note #1 — if your UPS supports writing battery.runtime.low, the new set value is to be entered in minutes (up to 99) but the reported value is reported in seconds (set value * 60). the math is mathing, don't worry. 🧮

note #2 — if your UPS supports input.transfer.low and input.transfer.high, those values are used to create an allowable output range. the UPS will do what it can to keep the output voltage value within the defined range (for example: tap change or switch to inverter). she's doing her best, okay 😭

---

🫶 AUTHORS 🫶

• Bill Elliot <bill@wreassoc.com>
• Eric Lawson <elawson@inficad.com>

---

🌸 SEE ALSO 🌸

The core driver:

• nutupsdrv(8)

Internet resources:

• The NUT (Network UPS Tools) home page: https://www.networkupstools.org/historic/v2.8.5/

---

and that's the whole page, bestie 💜 this was Network UPS Tools 2.8.5, dated 10/07/2026 — so when you're out here running oneac, know that the lore is real, the version is pinned, and you ate. mwah 🎀✨