Documentation

Remote Devices

You can manage your tunnels remotely from the Pinggy dashboard using the remote devices feature. All you need to do is run the Pinggy CLI and connect it in remote-management mode. This allows you to create, edit, and stop tunnels directly from the dashboard without needing physical access to your device.

This feature is available with Pinggy Pro and Enterprise plans.

Remote Device Management using Pinggy

Connecting a remote device

For connecting a remote device, you need to intall Pinggy CLI, and get an API Key.

Step 1. Install the Pinggy CLI by following the instructions here.

Step 2. Create an API Key from the dashboard by logging in to API Key. You can name your API key appropriately to later identify the device you are connecting.

You will receive an API key (example: xoBlIhaxriopBWSTZ7c62V) which can use to connect your CLI.

Step 3. Run the Pinggy CLI in remote management mode.

./pinggy --remote-management <YOUR_API_KEY>

Example:

./pinggy --remote-management xoBlIhaxriopBWSTZ7c62V

Manage tunnels for a remote device

To view your active remote devices, log in to https://dashboard.pinggy.io/activedevices

There you will find a list of your active devices. Click on the device you want to manage.

You can achive the following using remote device management:

  • Keep your remote device connected and initiate new tunnels whenever you want without physically accessing the device
  • Create new HTTP(S) / TCP / UDP / TLS tunnels
  • Modify and change settings of existing tunnels
  • Monitor the tunnels
List of active devices in Pinggy Remote Device Management
Device details in Pinggy Remote Device Management
Create new tunnel in Pinggy Remote Device Management
Initiate a new tunnel in Pinggy Remote Device Management
List of active tunnels of a remote device in Pinggy
Detailed information of an active tunnel in a remote device in Pinggy