---
name: "uptimed.conf"
section: "5"
platform: "linux"
package: "uptimed"
version: "1:0.4.6-3.1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/uptimed.conf"
---

# uptimed.conf(5)

The configuration file for uptimed(8)

## NAME

uptimed.conf - The configuration file for [uptimed(8)](/uptimed/8.md)

## DESCRIPTION

*uptimed.conf* contains a list of key-value pairs to configure the behaviour of [**uptimed**(8)](/uptimed/8.md), comments start with **#**. The beginning of *uptimed.conf* might look like the following:

```
# 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
```

The variables LOG\_MINIMUM\_UPTIMED,  MAIL\_MINIMUM\_UPTIME and MILESTONE expect a time unit which are encoded by a single letter.  **h** is used for hour, **d** is used for day,  **w** is used for weeks and **y** is used for years. Default (nothings specified) is seconds.

The default *uptimed.conf* is quite well commented so you should be able to use it as a basis. The following keys are supported:

- **UPDATE\_INTERVAL**

  Interval to write the logfile with in seconds, e.g. 60.

- **LOG\_MAXIMUM\_ENTRIES**

  Maximum number of entries in logfile, e.g. 50. Set to 0 for unlimited.

- **LOG\_MINIMUM\_UPTIMED**

  Minimum uptime that must be reached to be considered a record.

- **MAIL\_MINIMUM\_UPTIME**

  Minimum uptime before sending out e-mail.

- **MAIL\_MINIMUM\_POSITION**

  Minimum position in uptime ranking before sending out e-mail.

- **EMAIL**

  Email address to mail milestones/records to. Assumes [**sendmail**(8)](/sendmail/8.md) compatible MTA  installed as */usr/lib/sendmail*. You can enable this with SEND\_EMAIL or with the  **-e** option on the commandline.

- **SEND\_EMAIL**

  Controls if email is sent. 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.

- **SENDMAIL**

  Command to call a sendmail compatible mailer, e.g. /usr/lib/sendmail -t.

- **PIDFILE**

  Path to store PID file, e.g. */var/run/uptimed*

- **MILESTONE**

  Configurable milestones.  Syntax is pretty easy: MILESTONE=time:description. Keep in mind that the description needs to fit in the window.

### EXAMPLE FOR MILESTONE SETTINGS

```
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.

## SEE ALSO

[**uptimed**(8)](/uptimed/8.md), [**uprecords**(1)](/uprecords/1.md)