tuptime - Man Page

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


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]


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



-h | --helpShow this help message and exit
-A | --at STARTUPLimit to this startup number
-b | --bootidShow boot identifier
-c | --csvOutput in csv format
-d | --date DATETIME_FMTDatetime/timestamp format output
-e | --dec DECIMALSNumber of decimals in percentages
-E | --exclude STARTUPStartup numbers to exclude
-f | --file FILEDatabase file (file path)
-g | --gracefulRegister a graceful shutdown
-i | --invertStartup number in reverse count | swich between longest/shortest on default output
-k | --kernelShow kernel version
-l | --listEnumerate system life as list
-n | --noupAvoid update values into DB
-o | --order TYPEOrder enumerate by [u|r|s|e|d|k] (u = uptime | r = runtime | s = sleep time | e = end status | d = downtime | k = kernel)
-p | --powerShow power states run + sleep
-q | --quietUpdate values into DB without output
-r | --reverseReverse order in listings
-s | --secondsOutput time in seconds and epoch
-S | --since STARTUPLimit from this startup number
-t | --tableEnumerate system life as table
--tat TIMESTAMPReport system status at specific timestamp
--tsince TIMESTAMPLimit from this epoch timestamp
--tuntil TIMESTAMPLimit until this epoch timestamp
-U | --until STARTUPLimit up until this startup number
-v | --verboseVerbose output
-V | --versionShow version



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.



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.



Scheduled cron file.


Init file.


Systemd service unit file. Register time values into database.


Main and only executable file.


Directory with multiple documentation files.


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


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


Manual page.

See Also


Detailed documentation.


Official repository.


Ricardo Fraile <r@rfmoz.eu>


Jan 2024 5.2.3 General Commands Manual