
Pigeon is CGI program meant to sent messages from scripts or via the simple form on the main web page. Messages are saved into tsv files named after the given category then html files are generated, one for each and a main index page listing the categories.
Pigeon has no authentication since I made it to run only on my local network.

setup
Check out my CGI guide page for information on getting CGI itself setup.
Pigeon’s endpoints all start with /pigeon, assuming you’re using caddy and fastcgi, you can add an entry to your Caddyfile like this:
msg.example.com {
handle /pigeon* {
reverse_proxy unix///path/to/fcgiwrap.socket {
transport fastcgi {
env SCRIPT_FILENAME /path/to/pigeon/pigeon
}
}
}
root * /path/to/pigeon/html
file_server
}
The data and html directories will automatically be created in the same directory as the binary, though you can change that by adding env DOCUMENT_ROOT /other/path to the CGI handler. The template is defined within the binary and it can be modified by changing the pigeon_template variable in template.ha then running hare build -o pigeon . to recompile.
usage
You can use the web page form to manually add messages. To add via a script, make a requests with curl or similar:
add
curl -X POST -d "cat=backups" -d "msg=backup failed, could not connect to remote storage" http://msg.example.com/pigeon
delete
curl -X DELETE -d "cat=backups" -d "id=00000000000000000000000000000000" http://msg.example.com/pigeon
generate
The web form will automatically regenerate the pages when adding or removing messages but doing so with the above method won’t, this is so that if multiple messages need to be sent or removed it won’t pointlessly regenerate every time. You can generate manually with:
curl http://msg.example.com/pigeon/generate
add & generate
curl -X POST -d "cat=backups" -d "msg=backup failed, could not connect to remote storage" http://msg.example.com/pigeon/add
delete & generate
curl -X POST -d "cat=backups" -d "id=abc123" http://msg.example.com/pigeon/delete
releases
2026-09-14
changelog
- Move to my cgi library
- Add checked for empty parameters
- Add endpoints for adding and deleting messages without generating html