Install the Agent

The agent runs beside your service and keeps an outbound connection to Kepeink. You need one agent token for each tunnel you run.

Before you start

Create a tunnel in the dashboard and copy its kpt_… agent token. Keep the token private. The tunnel's target must be reachable from the machine where you run the agent.

1. Run the agent

The standard service install below runs with system privileges. Use --user without sudo on Linux/macOS for a user service, or use Docker.

On Linux or macOS, install it as a background service:

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

On Windows, open an elevated PowerShell session and run:

Invoke-WebRequest -UseBasicParsing https://cdn.kepeink.hu/install.ps1 -OutFile $env:TEMP\kepeink-install.ps1; & $env:TEMP\kepeink-install.ps1 -Token kpt_xxxxxxxx

The service starts on boot and reconnects if the connection drops.

2. Check the URL

Open the tunnel's assigned HTTPS URL from the dashboard. You should see your local app or files. If it does not load, check that the target is running and readable from the agent's machine, then check the agent logs. On Linux, use journalctl -u kepeink-agent -f.

Other ways to run it

• Short demo: On Linux or macOS, run in the foreground and stop with Ctrl-C:

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

• Docker app: Add the agent to your Compose project. The agent container must share a network with the app.

Next, follow Expose a local web app or Serve a static folder for the right target setting.

Installation and updates

The standard service install runs with system privileges. For a dedicated user, use --user without sudo, or choose Docker. See Agent installation and update reference for first-install verification, permissions, and self-updates.