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.
services:
tinystatus:
environment:
REFRESH_INTERVAL: '30'
image: baywolfstudios/tinystatus
ports:
- published: 8124
target: 80
restart: unless-stopped
volumes:
- /host/path/to/config:/config:rw
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
The syntax of checks.csv
file is:
Command, Expected Code, Status Text, Host to check
Command can be:
http
- Check http statusping
- Check ping statusport
- 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.