wingsite
Pigeon

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

Download binary

Download source

changelog

2026-08-06

Download binary

Download source