Expose a local web app

Already running a web app? A proxy tunnel gives it a public HTTPS URL. The agent connects out to Kepeink, so your app needs no public port.

Before you start

Open the app locally and note its address. For a dev server on port 3000, the target is http://localhost:3000. The target must be reachable from the machine running the agent.

1. Create the tunnel

In the dashboard, create a tunnel with Backend mode: proxy and Target: http://localhost:3000 (or your app's address). Copy the kpt_… agent token when it appears, and keep it private.

2. Run the agent

On the machine running your app, install the agent as a background service:

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

For a short demo, use the foreground run instead. If your app runs in Docker, run the agent in the same Compose project and use a target such as http://web:3000 rather than localhost.

3. Check the URL

Open the assigned HTTPS URL shown for the tunnel in the dashboard. Edits to your app appear on the next request.

If the URL returns a 404 while the local page works, your app may reject the public hostname in the Host header. Add that hostname to your app's allowed hosts or virtual-host configuration. For a branded URL, add a custom domain.