Install the DevTunnelInstaller

This section walks you through installing DevTunnelInstaller, the DevTunnel connection software, on Windows, Mac, and Linux (Debian only) workstations.


Before installing and using the DevTunnel feature on your development station, verify the following system requirements:

  • The DevTunnel Installation package requires Administration privileges on the development station.
  • Java JDK:

    • Windows and Mac workstations: Java JDK version 1.7 or later is installed. 


      The highest supported Java version is version 12.

    • Linux workstations: Java SDK version 1.8, 1.9, 1.10, or 1.11 is installed.


    Java from sources other than Oracle, such as openJAVA (JDK), are not supported.

  • Windows workstations only: .NET Framework v4.6 or later is installed.


    If the .NET framework is not pre-installed, it will be installed as part of the DevTunnel installation package

  • Linux workstations only:

    • USB multiplexer (usb-mux) is installed with the libimobiledevice-dev library. To install the library, run the following command:

      sudo apt-get install -y libimobiledevice-dev
    • (Optional) If you intend to run DevTunnel CLI scripts from the command line, cURL is installed. Run the following command to install cURL:

      sudo apt-get install curl
  • To run Appium on the machine, the version needs to match the Appium version in the Perfecto cloud.

  • Networking configuration:

    The local network employs the following:

    • transparent proxy to connect to the Perfecto Smart Lab. Verify that all Lab sites are included in the white-list of the proxy.

    • An explicit proxy with credential authentication to connect to the Perfecto Smart Lab. Follow the procedure on the Proxy Configuration page.

    • Web inspection. Verify that all Perfecto Smart Lab sites are included in the white list of the proxy.

Installation package

Perfecto provides an installation package that installs different software elements onto your computer. These elements allow you to:

  • Establish a secure connection between your development computer and the Perfecto Lab Handset Server.
  • Make the Android debugging tools identify the Perfecto device as connected to the development station.

Following is a list of the third-party packages that are part of the DevTunnel installation:

Download the installer package

  1. In the Manual Testing view, open a device.
  2. On the device toolbar, click the Connect DevTunnel icon .
  3. In the DevTunnel form, click Download DevTunnelInstaller.

    The download tool identifies the target development station's operating system (Windows or Mac) and downloads the proper installation package.

  4. Save the file on your local development station.

Install the package on the development station


If you use any of the following anti-virus software tools, add PerfectoInstaller.exe to the anti-virus exception list on your workstation:

  • Avira
  • Baid
  • Endgame
  • Invincea
  • Qihoo-360

The virus detection of these tools may falsely identify a virus associated with the installer package.

Uninstall DevTunnel

To uninstall DevTunnel, perform the instructions for your operating system.

Known Limitations

See here for the current list of limitations.