Tinystatus

tinystatus generate an html status page via shell script.

Features

• 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) | Currently commented
• Added config file inline option to run multiple instances from the original project

Demo

An example site is available here.

Setup

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
• Run the script every X minutes with crontab: */15 * * * * /opt/tinystatus/tinystatus -c /opt/tinystatus/checks.csv > /var/www/html/tinystatus.html 2>/dev/null

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.

Command line usage example

$ ./tinystatus --help
Usage: ./tinystatus -c <checkfile>
Options:
  -c, --checkfile <file>   Specify the check file (default: checks.csv)
  -h, --help               Display this help message

$ ./tinystatus -c checks.csv > /var/www/html/tinystatus.html