Expose a local web app

Use a proxy tunnel to put a web app or API that is already running on your machine online. In proxy mode the agent reverse-proxies a local HTTP(S) target you name and streams responses back to visitors.

1. Have your app running locally

Start the app you want to expose and note the address it listens on. For example a dev server on port 3000:

npm run dev
# → listening on http://localhost:3000

Any local HTTP(S) address works, including a service on your LAN such as http://192.168.1.5:8080.

2. Create a proxy tunnel

In the dashboard, create a tunnel with:

• Backend mode: proxy
• Target: the address from step 1, for example http://localhost:3000

Kepeink assigns the tunnel a public hostname and gives you an agent token.

3. Run the agent

Install the agent with the tunnel's token (see Install the Agent):

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

4. Open your public URL

Visit the assigned hostname from the dashboard. Requests arrive at Kepeink, travel down the open tunnel to your machine, and the agent forwards them to http://localhost:3000. The response streams back to the visitor over HTTPS.

Notes

• The target only has to be reachable from the machine running the agent — it never needs to be reachable from the internet.
• Changes you make to the app are live immediately; the tunnel just relays traffic, it does not cache your app.
• Want a branded URL? See Add a custom domain. Want the agent to hold the HTTPS certificate itself? See Turn on end-to-end TLS.