---
name: "tuptime"
section: "1"
platform: "linux"
package: "tuptime"
version: "5.2.4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/tuptime"
---

# tuptime(1)

Report historical and statistical real time of the system, preserving it between restarts. Total uptime.

## NAME

tuptime - Report historical and statistical real time of the system, preserving it between restarts. Total uptime.

## SYNOPSIS

tuptime \[-h\] \[-A STARTUP\] \[-b\] \[-c\] \[-d DATETIME\_FMT\] \[-e DECIMALS\] \[-E STARTUP\] \[-f FILE\] \[-g\] \[-i\] \[-k\] \[-l\] \[-n\] \[-o TYPE\] \[-p\] \[-q\] \[-r\] \[-s\] \[-S STARTUP\] \[-t\] \[--tat TIMESTAMP\] \[--tsince TIMESTAMP\] \[--tuntil TIMESTAMP\] \[-U STARTUP\] \[-v\] \[-V\]

## DESCRIPTION

Tuptime reports historical and statistical real time of  the system, preserving it between restarts. Indeed, it can:

\- Count system startups

\- Register first boot time (a.k.a. installation time)

\- Count nicely and accidentally shutdowns

\- Uptime and downtime percentage since first boot time

\- Accumulated system uptime (running and sleeping), downtime and total

\- Register used kernels and boot IDs

\- Report current uptime

\- Print formatted table or list with the system history

\- Narrow reports since, until or at a given startup or timestamp

\- Output in csv format

## OPTIONS

### ARGUMENTS

| | |
| --- | --- |
| -h \| --help | Show this help message and exit |
| -A \| --at STARTUP | Limit to this startup number |
| -b \| --bootid | Show boot identifier |
| -c \| --csv | Output in csv format |
| -d \| --date DATETIME\_FMT | Datetime/timestamp format output |
| -e \| --dec DECIMALS | Number of decimals in percentages |
| -E \| --exclude STARTUP | Startup numbers to exclude |
| -f \| --file FILE | Database file (file path) |
| -g \| --graceful | Register a graceful shutdown |
| -i \| --invert | Startup number in reverse count \| swich between longest/shortest on default output |
| -k \| --kernel | Show kernel version |
| -l \| --list | Enumerate system life as list |
| -n \| --noup | Avoid update values into DB |
| -o \| --order TYPE | Order enumerate by \[u\|r\|s\|e\|d\|k\] (u = uptime \| r = runtime \| s = sleep time \| e = end status \| d = downtime \| k = kernel) |
| -p \| --power | Show power states run + sleep |
| -q \| --quiet | Update values into DB without output |
| -r \| --reverse | Reverse order in listings |
| -s \| --seconds | Output time in seconds and epoch |
| -S \| --since STARTUP | Limit from this startup number |
| -t \| --table | Enumerate system life as table |
| --tat TIMESTAMP | Report system status at specific timestamp |
| --tsince TIMESTAMP | Limit from this epoch timestamp |
| --tuntil TIMESTAMP | Limit until this epoch timestamp |
| -U \| --until STARTUP | Limit up until this startup number |
| -v \| --verbose | Verbose output |
| -V \| --version | Show version |

### ENVIRONMENT

TUPTIME\_DBF

Set an alternative database file path. The argument -f, --filedb takes precedence over this.

## DEFAULT OUTPUT

System startups:

Total number of system startups from since first timestamp available.

System shutdowns:

Total number of shutdowns done correctly or incorrectly.

System life:

Time counter since first startup timestamp available.

System uptime:

System downtime:

Percentage of time and time counter.

Longest uptime:

Longest downtime:

Time counter and date with the complete longest uptime/downtime register.

Average uptime:

Average downtime:

Average time counter.

Current uptime:

Actual time counter and datetime since registered boot timestamp.

## EXAMPLES

- **tuptime**

  Default output.

- **tuptime -t**

  Enumerate system life as table.

- **tuptime -l**

  Enumerate system life as list.

- **tuptime -k**

  Add kernel information to the output.

- **tuptime --csv**

  Report in csv format.

- **tuptime -s**

  Change default human readable datetime/timestamp style and print times in seconds and datetimes in epoch.

- **tuptime -d '%H:%M:%S %m-%d-%Y'**

  Change the datetime/timestamp format. By default the output use the configured system locales.

- **tuptime --tsince -31557600**

  Report since one year ago.

## FILES

- */etc/cron.d/tuptime*

  Scheduled cron file.

- */etc/init.d/tuptime*

  Init file.

- */lib/systemd/system/tuptime.service*

  Systemd service unit file. Register time values into database.

- */usr/bin/tuptime*

  Main and only executable file.

- */usr/share/doc/tuptime/*

  Directory with multiple documentation files.

- */lib/systemd/system/tuptime-sync.timer*

  Systemd .timer unit for use instead of cron. Only executes tuptime-sync.service.

- */lib/systemd/system/tuptime-sync.service*

  Systemd .service unit required by tuptime-sync.timer. Updates time values into database.

- */usr/share/man/man1/tuptime.1*

  Manual page.

## SEE ALSO

- */usr/share/doc/tuptime/tuptime-manual.txt.gz*

  Detailed documentation.

- *https://github.com/rfmoz/tuptime/*

  Official repository.

## AUTHOR

Ricardo Fraile \<r@rfmoz.eu\>

## COPYRIGHT

Copyright (C) 2024 by Ricardo F. All Rights Reserved.

This product is distributed in the hope that it will be useful, but WITHOUT any warranty; without even the implied warranty of  MERCHANTABILITY or FITNESS for a particular purpose.