Serve a static folder

Use a static tunnel to publish a folder of files directly. In static mode the agent serves the folder itself, so you do not need to run any application server — useful for a built site, documentation, or a bundle of downloads.

1. Have a folder ready

Point the tunnel at a folder that contains what you want to publish. For a static site, that is usually a build output directory:

# a built site
ls ./dist
# index.html  assets/  favicon.ico

An index.html at the folder root is served as the default page.

2. Create a static tunnel

In the dashboard, create a tunnel with:

• Backend mode: static
• Target: the path to the folder you want to serve, for example ./dist

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

3. Run the agent from the right place

Run the agent on the machine that holds the folder, using the tunnel's token:

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

Make sure the folder path is correct for the machine and user the agent runs as.

4. Open your public URL

Visit the assigned hostname. The agent reads files straight from the folder and serves them over HTTPS. Update a file in the folder and the change is live on the next request.

proxy vs static

• Choose static when you just have files to serve and no app behind them.
• Choose proxy when a program is already serving the content and you want Kepeink to forward to it. See Expose a local web app.