// github integration

Receive GitHub webhooks on your laptop

GitHub fires webhooks on every push, PR, and issue. You want a stable public URL that survives restarts so the repo's webhook config stays put across days of development.

1 · Set up the lrok tunnel

1. Reserve
```
$ lrok reserve gh-hooks
```
2. Run handler
```
$ go run ./cmd/webhook-handler
```
3. Tunnel
```
$ lrok http 8080 --hint gh-hooks
```

2 · Configure GitHub

1. Repo → Settings → Webhooks → Add webhook
Payload URL: https://gh-hooks.lrok.io/event (or whatever route you handle). Content type: application/json. Secret: a strong random string.
2. Pick events
Default ("Just the push event"), specific events, or "Send me everything". Start narrow.
3. Hit Add webhook — GitHub fires a ping immediately
Watch the lrok request inspector at /dashboard/tunnels/<sub> to confirm delivery.

// github-specific gotcha

GitHub uses X-Hub-Signature-256: sha256=<hex>. Strip the sha256= prefix before HMAC comparison. The body is signed verbatim — same whitespace caveat as Stripe.

Start free Install the CLI Verify a signature →

Receive GitHub webhooks on your laptop

1 · Set up the lrok tunnel

1. Reserve

2. Run handler

3. Tunnel

2 · Configure GitHub

1. Repo → Settings → Webhooks → Add webhook

2. Pick events

3. Hit Add webhook — GitHub fires a ping immediately

More integrations