UPTIMED.CONF(5)

✨ uptimed.conf(5) ✨

okay bestie, gather round, we're talking about uptimed.conf — the lil config file for uptimed(8). it's giving "settings but make it cute". 💅

---

🌸 NAME 🌸

uptimed.conf — the config file for uptimed(8), no cap 🫶

---

💖 DESCRIPTION 💖

so uptimed.conf is literally just a big ol' list of key-value pairs that tell uptimed(8) how to behave. that's it, that's the whole vibe. 💫

comments start with # — yes, like every other self-respecting config file, slay.

the beginning of uptimed.conf might look like this:

# Uptimed configuration file.

# Interval to write the logfile with in seconds.
UPDATE_INTERVAL=3600

# Maximum number of entries in logfile. Set to 0 for unlimited.
LOG_MAXIMUM_ENTRIES=500

now listen, this part is important 👇 the variables LOG_MINIMUM_UPTIMED, MAIL_MINIMUM_UPTIME and MILESTONE want a time unit, and you write it as a single letter. the whole alphabet tea:

• h → hour ⏰
• d → day ☀️
• w → weeks 📅
• y → years 🎂

and if you specify nothing at all? default is seconds. periodt.

the default uptimed.conf is genuinely super well commented, so fr fr you can just use it as your starting point. it's iconic like that. here are the keys that are supported:

• UPDATE_INTERVAL — how often (in seconds) to write the logfile, e.g. 60.
• LOG_MAXIMUM_ENTRIES — max number of entries in the logfile, e.g. 50. set it to 0 for unlimited. go big or go home 💅
• LOG_MINIMUM_UPTIMED — the minimum uptime you gotta reach for it to count as a record.
• MAIL_MINIMUM_UPTIME — minimum uptime before an e-mail goes out.
• MAIL_MINIMUM_POSITION — minimum position in the uptime ranking before an e-mail goes out.
• EMAIL — the email address to mail milestones/records to. this assumes you have a sendmail(8) compatible MTA installed as /usr/lib/sendmail. you can turn this on with SEND_EMAIL or with the -e option on the commandline. 📧
• SEND_EMAIL — controls whether email is sent at all. use 0 if you never want an email, 1 if you want emails for both milestones and records, 2 if you want emails only for milestones, and 3 if you want emails only for records. pick your fighter.
• SENDMAIL — the command to call a sendmail compatible mailer, e.g. /usr/lib/sendmail -t.
• PIDFILE — path to store the PID file, e.g. /var/run/uptimed
• MILESTONE — configurable milestones! the syntax is pretty easy: MILESTONE=time:description. keep in mind the description needs to fit in the window 👀 (yes, really, it's a window thing).

🎀 EXAMPLE FOR MILESTONE SETTINGS 🎀

here's the whole roster, straight up, no edits:

MILESTONE=5d:five days
MILESTONE=10d:ten days
MILESTONE=25d:twenty-five days
MILESTONE=50d:fifty days
MILESTONE=10w:ten weeks
MILESTONE=75d:seventy-five days
MILESTONE=100d:hundred days
MILESTONE=150d:hundred and fifty days
MILESTONE=25w:twenty-five weeks
MILESTONE=200d:two hundred days
MILESTONE=250d:250 days
MILESTONE=300d:three hundred days
MILESTONE=50w:fifty weeks
MILESTONE=1y:one year
MILESTONE=400d:four hundred days
MILESTONE=500d:five hundred days
MILESTONE=100w:hundred weeks
MILESTONE=750d:750 days
MILESTONE=1000d:thousand days

---

👑 AUTHOR 👑

this man page was written by Helge Kreutzmann <kreutzm@itp.uni-hannover.de> for the Debian GNU/Linux project but may be used by others. queen behavior, honestly. 🫶

---

🌈 SEE ALSO 🌈

• uptimed(8)
• uprecords(1)

---

and that's the whole page bestie!! go configure something iconic ✨ this was uptimed.conf, from the uptimed.conf source, dated 07 February 2022 — mwah, love u, bye 💖🎀🦋