A lightweight GitHub webhook proxy for Discord.

docker run --name gohook -d -p 8080:8080 ghcr.io/krabiworld/gohook

services:
  gohook:
    image: "ghcr.io/krabiworld/gohook"
    ports:
      - "8080:8080"

helm repo add gohook https://krabiworld.github.io/gohook
helm install gohook gohook/gohook

Or you can use OCI repository:

helm install gohook oci://ghcr.io/krabiworld/gohook

See helm/values.yaml

You can download precompiled binaries for Linux, macOS and Windows from the GitHub Releases page.

To build gohook from source, you only need Go (the version specified in go.mod or later).

Start by cloning the repository:

git clone https://github.com/krabiworld/gohook.git
cd gohook

Then build the binary and run it:

go build ./cmd/gohook
./gohook

1. Create a webhook in Discord
   1. Go to Discord channel settings -> Integrations
   2. Click Create Webhook, give it a name
   3. Copy the webhook URL
2. Configure GitHub
   1. Go to https://github.com/<username>/<repository>/settings/hooks/new
   2. In Payload URL, paste the copied Discord Webhook URL and replace https://discord.com/api/webhooks with your Gohook URL

   Original Discord URL:
   https://discord.com/api/webhooks/123456/abcdef
   
   Replace with Gohook URL:
   https://gohook.your-domain.com/123456/abcdef
   

   3. In Content Type, select application/json
   4. In Secret, paste your secret (if you set environment variable SECRET)
   5. In Which events would you like to trigger this webhook?, select Send me everything.
   6. Click Add webhook

All environment variables are optional.

• GET: /health
• POST: /:id/:token

All standard environment variables are supported, such as HTTP_PROXY, HTTPS_PROXY and ALL_PROXY.