|SNARE(1)||General Commands Manual||SNARE(1)|
snare — GitHub
snare is a GitHub webhooks daemon. When
snare receives a webhook event from a given
repository, it authenticates the request, and then executes a user-defined
“per-repo program” with information about the webhook
The options are as follows:
snarenot to daemonise: in other words, `snare` stays in the foreground and logs errors to stderr. This can be useful for debugging.
snare runs an HTTP server which GitHub can
send webhook requests to. Configuring a webhook for a given GitHub
repository is relatively simple: go to that repository, then
“Settings > Webhooks > Add webhook”. For
“http://yourmachine.com:port/”, specify a
“secret” (which you will then reuse as the
secret in snare.conf(5)) and then choose
which events you wish GitHub to deliver.
snare runs an HTTP server. If you wish, as
is recommended, to send your webhooks over an encrypted connection, you will
need to run a proxy in front of
When run as a daemon,
snare logs to
syslogd(8) under the “daemon” facility.