PingDart Tunnel CLI — pingtl

Expose localhost to the internet with one command.

Installation

npm install -g pingdarttunnel

Quick Start

# 1. Login (auto opens browser)
pingtl login

# 2. Start tunnel
pingtl start --port 3000

# Output:
# ⚡ PingDart Tunnel — Connected
# Local URL:  http://localhost:3000
# Public URL: https://cloudapi.pingdart.com/tanel/PD-ABCD1234
# Status:     🟢 Online

Commands

| Command | Description | |---|---| | pingtl login | Authenticate via browser (auto-login) | | pingtl logout | Remove credentials | | pingtl start --port 3000 | Start tunnel on port 3000 | | pingtl start --port 3000 --name my-api | Named tunnel | | pingtl list | List all tunnels | | pingtl status | Show auth status | | pingtl dashboard | Open dashboard in browser | | pingtl doctor | Diagnose connectivity | | pingtl version | Show version |

How It Works

Your App (localhost:3000)
         ↓
    pingtl CLI (TCP)
         ↓  [Encrypted Connection]
  PingDart Gateway (port 3050)
         ↓
   Public HTTPS URL
  https://cloudapi.pingdart.com/tanel/PD-XXXX
         ↓
    Internet Clients

Configuration

Credentials and config are stored in ~/.pingdart/config.json.

Environment Variables (Local Testing)

You can override the default API and Gateway URLs using environment variables, which is useful for local testing or custom deployments:

# Connect to a local development environment
export PINGDART_API_URL=http://localhost:5000
export PINGDART_DASHBOARD_URL=http://localhost:3000
export PINGDART_TUNNEL_HOST=localhost
export PINGDART_TUNNEL_PORT=3050

pingtl start --port 3000

Dashboard

View and manage all tunnels at: https://app.pingdart.com/user/dashboard/deployments