// use case

Expose your Django dev server to GitHub for GitHub webhooks

1. 1

   Reserve a stable subdomain

   On the lrok free plan you keep one reserved subdomain forever. Pick a name your GitHub dashboard can hold onto — webhook URLs that survive laptop restarts mean fewer dashboard re-pastes.

   $ lrok reserve dja-github
     Reserved https://dja-github.lrok.io

2. 2

   Run your Django app

   Start the dev server on port 8000 (the Django default).

   $ python manage.py runserver

3. 3

   Tunnel localhost to the public URL

   lrok forwards https://dja-github.lrok.io/webhooks/ → http://127.0.0.1:8000/webhooks/. The flag --hint binds your reserved subdomain to this tunnel.

   $ lrok http 8000 --hint dja-github
     Forwarding https://dja-github.lrok.io  ->  http://127.0.0.1:8000

4. 4

   Paste the URL into GitHub

   Repository → Settings → Webhooks → Add webhook. Paste https://dja-github.lrok.io/webhooks/ as the destination.

5. 5

   Watch deliveries land in the request inspector

   Every webhook GitHub sends shows up at lrok.io/dashboard with full body, headers, status, and latency. Re-deliver any request to your Django handler with one click. GitHub's X-Hub-Signature-256 header is HMAC-SHA-256 over the raw body. The "Recent Deliveries" tab lets you replay any payload — combine it with lrok's built-in inspector for a tight loop.