Inspin Digital Status Page
Go to file
Ryan Moon 0402eb320d initial commit 2024-05-19 17:38:00 -04:00
LICENSE initial commit 2024-05-19 17:38:00 -04:00 Update 2021-06-03 22:31:26 +02:00
checks.csv initial commit 2024-05-19 17:38:00 -04:00
incidents.txt initial commit 2024-05-19 17:38:00 -04:00
tinystatus Add custom header (#17) 2021-07-09 08:33:11 +02:00


tinystatus generate an html status page via shell script.


  • Parallel checks
  • HTTP, ping, port checks
  • HTTP expected status code (401, ...)
  • Minimal dependencies (curl, nc and coreutils)
  • Easy configuration and customisation
  • Tiny (~1kb) optimized result page
  • Incident history (manual)


An example site is available here.


To install tinystatus:

  • Clone the repository and go to the created directory
  • Edit the checks file checks.csv
  • To add incidents or maintenance, edit incidents.txt
  • Generate status page ./tinystatus > index.html
  • Serve the page with your favorite web server

Configuration file

The syntax of checks.csv file is:

Command, Expected Code, Status Text, Host to check

Command can be:

  • http - Check http status
  • ping - Check ping status
  • port - Check open port status

There are also http4, http6, ping4, ping6, port4, port6 for IPv4 or IPv6 only check.
Note: port4 and port6 require OpenBSD nc binary.