Install DevTunnelInstaller

Learn how to install DevTunnelInstaller, the DevTunnel connection software, on Windows, Mac, and Linux (Debian only) workstations.

Known limitations

The current release of DevTunnel has the following limitations:

  • DevTunnel works with Java 17 and earlier.
  • If a device is directly connected to the development station when starting the DevTunnel session, DevTunnel will block this device and it will not be accessible from any tool.
  • When Chrome inspect is active in a DevTunnel session, the following actions in the Perfecto Plugin may fail:
    • Object Spy - element click
    • Object Spy - find elements
  • When using XCTest, on a DevTunnel-connected device, in Xcode, do not perform any interactive operations on the device. Such operations will stop the running XCTest package.
  • DevTunnel is supported on all devices. However, when used on a Windows machine, DevTunnel is supported only on Android devices. When used on a macOS machine, DevTunnel is supported on both Android and iOS devices.


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 Development Kit (JDK):

    • Windows and Mac workstations: JDK version 1.7 or later is installed. The highest supported Java version is version 17.

      Important: On Mac workstations, verify that no other Java versions, especially x86 Java, or Java versions from different vendors are present in the JAVA_HOME folder on your Mac machine.
    • Linux workstations: JDK version 8 or later is installed. The highest supported Java version is version 17.

  • Windows workstations only: .NET Framework version 4.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.

  • The configuration of your local network must employ the following:

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

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

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

  • If your company maintains a strict firewall policy, contact your IT department and ask them to add the following URLS to the allow list. For the installation to succeed, these URLs must be allowed and accessible by DevTunnelInstaller.

    • <your_cloud>

      For example:


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 installation package

  1. If you use any of the following anti-virus software tools, add PerfectoInstaller.exe to the anti-virus exception list on your workstation. Otherwise, the virus detection of these tools may falsely identify a virus associated with the installer package.

    • Avira
    • Baid
    • Endgame
    • Invincea
    • Qihoo-360
  2. In the Manual Testing view, open a device.
  3. On the device toolbar, click the Connect DevTunnel icon .
  4. In the DevTunnel dialog box, click Download DevTunnelInstaller.

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

  5. Save the file on your local development station.

Install the package on the development station

Depending on your operating system, you may need to perform additional steps before you can run the installer. Click an operating system below to view the relevant steps.

Uninstall DevTunnel

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