Scroll to navigation

TUPTIME(1) Linux Manual TUPTIME(1)


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


tuptime [{-h | --help}] [{-A | --at}=<startup>] [{-b | --bootid}] [{-c | --csv}] [{-d | --date}=<datetime format>] [-e | --dec=<decimals>] [{-f | --filedb}=<file>] [{-g | --graceful}] [{-i | --invert}] [{-k | --kernel}] [{-l | --list}] [{-n | --noup}] [{-o | --order}=[u|r|s|e|d|k]] [{-p | --power}] [{-r | --reverse}] [{-s | --seconds}] [{-S | --since}=<startup>] [{-t | --table}] [--tat=<timestamp>] [--tsince=<timestamp>] [--tuntil=<timestamp>] [{-U | --until}=<startup>] [{-v | --verbose}] [{-V | --version}] [{-x | --silent}]


Tuptime report historical and statistical real time of the system, keeping 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



-h | --help Show this help message and exit
-A | --at STARTUP Restrict to this startup number
-b | --bootid Show boot identifier
-c | --csv Output in csv format
-d | --date DATETM_FORMAT Datetime/timestamp format output
-e | --dec DECIMALS Number of decimals in percentages
-f | --file FILE Database file (file path)
-g | --graceful Register a graceful shutdown
-i | --invert Startup number in reverse count
-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
-r | --reverse Reverse order in list or table output
-s | --seconds Output time in seconds and epoch
-S | --since STARTUP Restrict from this startup number
-t | --table Enumerate system life as table
--tat TIMESTAMP Report system status at specific timestamp
--tsince TIMESTAMP Restrict from this epoch timestamp
--tuntil TIMESTAMP Restrict until this epoch timestamp
-U | --until STARTUP Restrict up until this startup number
-v | --verbose Verbose output
-V | --version Show version
-x | --silent Update values into DB without output



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


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.

Average uptime:
Average downtime:
Time counter with the average time.

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.
Main and only executable file.
Directory with multiple documentation files.
Optional .timer unit for use instead of cron.
Optional .service unit required by tuptime-cron.timer
Manual page.


Detailed documentation.
Official repository.


Ricardo Fraile <>


Copyright (C) 2021 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.

Nov 2020 5.0.2