:octocat: GitHub webhook handler
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
scripts/lfairy
.gitignore
LICENSE
README.md
add-secret
arroyo.conf
arroyo.py
arroyo.service
config.py

README.md

Arroyo, the webhook handler

Arroyo is a server that accepts GitHub webhooks.

Dependencies

  • Python 3.3 or newer

  • Linux

Setting up

  1. Start the daemon

    $ ./arroyo.py
    Started server on :8144
    Started worker thread
    
  2. Create a handler script

    $ mkdir -p scripts/myname
    $ cat >scripts/myname/myrepo <<EOF
    #!/bin/sh
    echo 'Hello, world!'
    EOF
    $ chmod +x scripts/myname/myrepo
    
  3. Generate a secret key

    $ ./add-secret myname/myrepo
    Added myname/myrepo to /srv/arroyo/secrets
    
  4. Tell GitHub about your hook

systemd and Upstart

A sample systemd unit file is provided in arroyo.service.

A sample Upstart job file is provided in arroyo.conf.

License

AGPL version 3 or newer.