Installing Tunnel
In a nutshell
The tunnel application connects your local network to QEngine's cloud infrastructure, allowing cloud-based browsers to access privately or locally hosted web applications during test execution. This page covers system requirements and installation steps for Mac, Windows, and Linux.
1. Download and Install Tunnel Application
Zoho QEngine supports testing privately or locally hosted web applications in the cloud. It allows you to manage network traffic and ensures the privacy and security of your testing activities. To do this, you need to configure the tunnel for your network. Learn more about tunnel.
To initiate the tunnel setup, begin by verifying that your system meets the necessary requirements, then proceed with the appropriate steps based on your operating system.
Note: The tunnel feature is supported for Mac, Windows, and Linux operating systems.
1.1 System requirements
Hardware | Minimum |
RAM | 4 GB |
Processor | 2 CPU cores |
1.2 Installation of Tunnel Application
To install the tunnel application:
Navigate Setup > Test Execution > Tunnels to download the installable for your machine.
or
From Projects, navigate to Settings > Tunnels for the same.
Select and download the file for the required OS.
1.2.1 Install tunnel for macOS:
- To initiate the installation process, double-click the downloaded installable.
- In the popup, drag and drop the tunnel application to the Applications folder.
- Run the tunnel by clicking on the installed application. If the tunnel is successfully running, you should see the Zoho QEngine (
) icon in the system tray.
- Click OK. Navigate to System Settings > Privacy & Security and scroll down to the Security section. Select the App Store and identified developers option. Give permission to your system to make the changes.
- Upon clicking the icon (
), the drop-down will allow you to perform various actions.
1.2.2 Install tunnel for Windows:
- To start the installation, double-click the downloaded installable.
- Click Next in the InstallShield Wizard for Zoho QEngine.
- Read the License Agreement, then accept the terms and conditions.
- Set the Destination Folder, then click Next.
- Once the installation is complete, click Finish.
If the tunnel is successfully running, you should see the Zoho QEngine (
) icon in the system tray.
1.2.3 Install tunnel for Linux:
- Download the Linux Installation file (.bin) file
- Open terminal and navigate to the file downloaded path
- Change the bin file to executable mode, using the following command:
chmod +x ZohoQEngine-Tunnel-64bit-<version>.bin - To start the installation, run the following command:
./ZohoQEngine-Tunnel-64bit-<version>.bin - After executing the bin file, the InstallationShield will be open. Follow the steps in the InstallationSield Wizard and complete the installation.
Upon successful installation, the tunnel will be started automatically.
Steps for Uninstalling Linux Tunnel:
- Navigate to the folder where the Zoho QEngine Tunnel is installed using the terminal.
- Execute the command below:
./Uninstall\ ZohoQEngine - Follow the steps in the wizard and complete the uninstallation.
Steps to update to the Latest Version:
- Download the .bin file from qengine.zoho.com
- Open the terminal and navigate to the path where the file is downloaded.
- Change the bin file to executable mode using the following command:
- To start the installation, run the following command:
- After executing the bin file, InstallationShield will be open.
- If the user tries to update the tunnel while the older instance is already running, the Prerequisite window will pop up.
Clicking on Yes will remove the older version of tunnel and the new version will be installed. - If the user tries to update the tunnel on the existing tunnel's path, the confirmation window will pop up.
Clicking on Yes will remove the older version of the tunnel and new version will be installed.
Upon successful installation, the tunnel will be started automatically.
Note:
- Tunnel will only start automatically at the time of installation. For manual start, navigate to the /home/<user-name>/Desktop/ZohoQEngine folder in the terminal and run the command below:
./StartServer - For stopping the tunnel, navigate to the /home/<user-name>/Desktop/ZohoQEngine folder using the terminal and run the command below:
./StopServer
2. Related Links
Access your files securely from anywhere
Zoho CRM Training Programs
Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.
Zoho DataPrep Personalized Demo
If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
Centralize Knowledge. Transform Learning.
All-in-one knowledge management and training platform for your employees and customers.
New to Zoho Writer?
Create. Review. Publish.
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Zoho Marketing Plus?
Everything you need to run your marketing
You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.
New to Zoho Survey?
Zoho Sheet Resources
Zoho Forms Resources
New to Zoho Sign?
Zoho Sign Resources
Sign, Paperless!
New to Zoho TeamInbox?
Zoho TeamInbox Resources
New to Zoho ZeptoMail?
Design. Discuss. Deliver.
New to Zoho Workerly?
New to Zoho Recruit?
New to Zoho CRM?
New to Zoho Projects?
New to Zoho Sprints?
New to Zoho Assist?
New to Bigin?
Related Articles
Tunnel
In a nutshell The tunnel in Zoho QEngine is a secure connection between your local network and Zoho Cloud, enabling cloud-based browsers to reach locally hosted or firewall-protected applications during test execution. You can set up a tunnel by ...Installing Agent
In a nutshell The local agent is a lightweight application that connects your local machine to QEngine's cloud infrastructure, enabling you to run automated test cases on your own devices. This page covers the system requirements and installation ...Introduction to Zoho QEngine
In a nutshell Zoho QEngine is a unified test automation platform for your entire testing lifecycle. From test creation and management to execution and reporting, everything lives in one workspace. It supports cross-platform testing across web, ...Integrating Zoho QEngine with Jenkins
In a nutshell The Jenkins integration in Zoho QEngine connects automated test plan execution directly into a CI/CD pipeline. Using the Zoho QEngine Test Plan Execution plugin for Jenkins, you can trigger test plan runs as part of any build step, ...Creating mobile test cases using recorder
In a nutshell Zoho QEngine's recorder captures your physical interactions within a mobile application and converts them into automation test scripts automatically, without requiring you to write scripts manually. It is accessed from the test case ...
New to Zoho LandingPage?
Zoho LandingPage Resources