Receive webhooks on a local app

Let a webhook provider call a handler on your development machine. Keep your handler's normal signature verification enabled; the tunnel makes it reachable but does not authenticate webhook senders for you.

Before you start

Run the handler locally. For a handler at http://localhost:4000/hooks, the tunnel target is just http://localhost:4000; /hooks stays in the provider's webhook URL.

1. Create the tunnel

In the dashboard, create a proxy tunnel with Target: http://localhost:4000. Copy the kpt_… agent token and keep it private.

2. Run the agent

For a development session, run the agent in the foreground:

curl -fsSL https://cdn.kepeink.hu/run.sh | sh -s -- --token=kpt_xxxxxxxx

3. Check delivery

Set the provider's webhook URL to https://<assigned-hostname>/hooks. Trigger a test event and check your local handler logs. Press Ctrl-C when testing is done. If the provider needs a hostname you control, add a custom domain.