= Command prompt interface - pCloudy documentation

Command prompt interface

Heeding to the growing demands, pCloudy brings to you the command line Device Tunnel interface which helps developers to build their Android or iOS apps and put it to test on a real device as if the device is connected to their local system. Now, real devices on cloud can be accessed by running few commands on the command line interface.


  • JDK 8 and above.
  • Android-sdk latest version.

Jar download path


This will be a one-time activity and need not be repeated again.

Steps to Run the Jar

Step 1: Run the device tunnel jar by passing the cloud url, user name and api key

Eg: java –jar pCloudy_DeviceTunnel.jar https://device.pcloudy.com test@pcloudy.com skdflj4tlko46lsa

Note: Mention the device tunnel jar path where you store the downloaded pCloudyDeviceTunnel.jar

Ex: Here, the jar is saved in desktop so the path would be like

java –jar /Desktop/pCloudy_DeviceTunnel.jar https://device.pcloudy.com test@pcloudy.com skdflj4tlko46lsa

Java Jar File

Step 2: You can filter devices based on Manufacturer, version or based on all parameters. Press the number of the filter type and press enter.


Note: Please select android version 5.0.0 and above.

a) To find the devices based on OEM, type 1 and press enter.


Type the name of the manufacturer to filter the devices based on OEM and press enter. In this example we have filtered Samsung devices.

filter the devices

It will display a list of all Samsung devices available over cloud.

select any device press enter

b) To find the devices based on version, type 2 and enter.


Type the version number to display the list of devices available on cloud with that version. In this example, we have filtered the devices based on version number 7.0.0.

Note: Type the full version number as shown here - 7.0.0. If you just type 7.0, filters won't be applied.

Enter device version

It will display a list of all devices of version 7.0.0 available over cloud.

version 7.0.0 available cloud

c) To find all the devices available over cloud, type 3 and press enter.

type 3

It will display a list of available devices in that cloud.


Step 3: Select any one device by mentioning the device number and press enter.

device ID

Step 4: Enter the duration (in minutes) for which you want to book the device, then press enter.

book the device

Step 5: Selected device gets connected to your system.

selected device

Step 6: Open another terminal and check if the device is connected or not

device connected

Step 7: If the device list shows as unauthorized then copy the url displayed by the jar and paste it in the browser.

device list browser

Step 8: Click on ok option on the device and check device list again in terminal.

click Ok check device list

Now device is connected to your system. You can use this device like a local device.

Note: If you want to exit from the device tunnel jar, please type ‘EXIT/exit’.


Note: pCloudy command Line DeviceTunnel Interface is only available for Android devices on public and private cloud. It is available for both Android and iOS on on-premise cloud.