NUT-RECORDER(8)

✨ NUT-RECORDER(8) ✨

okay bestie, welcome to the NUT Manual section for nut-recorder — the little tool that records everything your UPS is doing so you can replay it later 💅

---

🌸 NAME 🌸

nut-recorder — a utility to record device status and values changes 🎀

---

🦋 SYNOPSIS 🦋

nut-recorder device-name [output-file] [interval]

---

💖 DESCRIPTION 💖

so like, nut-recorder is a utility that records sequences from running devices (think power failures, or literally any other value changes) straight out of the upsd(8) data server, and dumps the whole thing into a .seq format. no cap. 📼

then that .seq file can be handed to the dummy-ups(8) driver to replay the sequence. iconic behaviour honestly. ✨

---

💅 OPTIONS 💅

• device-name — record the changes of this device, bestie. the format is devname[@hostname[:port]]. and the default hostname? "localhost". periodt. 🏠
• output-file — optional! the data gets saved to this file. default is dummy-device.seq. 💾
• interval — also optional! the status of the device gets checked every interval. default is 5 seconds. ⏰

---

🔥 EXAMPLES 🔥

say you wanna record data from ups1@host1 every 10 seconds. here's the vibe:

:; nut-recorder ups1@host1' ups1-output.seq 10
. . .
battery.charge: 100.0
battery.voltage: 13.9
battery.voltage.nominal: 13.6
ups.status: OL
. . .
battery.charge: 90.0
ups.status: OB
. . .

and then you can define a dummy device in ups.conf(5), like so:

[ups-test]
        driver = dummy-ups
        port = ups1-output.seq

look at that. main character energy. 👑

---

🌈 AUTHOR 🌈

Arnaud Quette 🫶

---

⭐ SEE ALSO ⭐

🧚 The dummy-ups driver:

• dummy-ups(8)

🍓 The logging daemon:

• upslog(8)

💜 Internet resources:

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

---

and that's the whole thing!! this page came to you from Network UPS Tools 2.8.5, dated 10/07/2026 — slay, bye bestie 💖✨🎀