Hooktail is an HTTP server written in Go that can be used for github webhook deployments.

• Go >= 1.13

Copy the sample configuration file and edit as per your liking:

cp config.example.yml config.yml

The available configuration is listed in the config.example.yml file.

You can run all the available unit tests using the command below:

go test -v ./...

You can build and run the server using the following commands:

go build && sudo ./hooktail

NOTE: sudo is required in order to be able to run a deployment as a specific user.

In order to specify a custom configuration file (other than config.yml) you can use the following flag:

sudo ./hooktail -config <path-to-config.yml>

Since Hooktail only supports HTTP, it cannot handle SSL termination. In order to handle SSL termination you need a reverse proxy such as:

• Nginx
• Haproxy