CDNShark Documentation

Tunnel

← Back to Documentation

Create a Tunnel and Install the Connector

1. Create the tunnel

  1. Go to Private Tunnel in your dashboard and click Create Tunnel.
  2. Give it a name you will recognise, such as the machine or the site it serves.

You will be shown an install command containing a one-time token. Copy it immediately — it is displayed once, expires after 15 minutes, and can only be used a single time. If you lose it, use Generate new install command.

2. Install on Linux or macOS

Run the command shown in the portal on the machine that serves your site:

curl -fsSL https://cdnshark.com/install/tunnel.sh | sudo bash -s -- --token=YOUR_TOKEN

It downloads the connector, verifies its checksum, enrols, and on Linux starts a systemd service that survives reboots. On macOS there is no service manager yet, so start it with cdnshark-tunnel run.

3. Install on Windows

The shell installer does not run on Windows. Open the Windows tab on your tunnel page and follow the PowerShell steps — they download and verify the binary, enrol, and register a startup task so it runs as a service account after a reboot.

4. Check it worked

The tunnel page should show Online with a green WireGuard/UDP badge within a minute. The machine only needs outbound internet access — nothing else.