Common questions
Do I need separate agents for different on-premise applications in the same machine?
No. You just need one agent to connect any number of on-premise applications on a single machine.
What happens if my system crashes and is recovered later? Will it affect my flows?
If you're able to recover your system after the crash, and the agent's files are intact in your system, you can start the agent again. If you're unable to recover your system, you must unregister the agent from Settings > Agents > View Details which will permanently disconnect the agent. After unregistering, reinstall the agent using the Installation Key available in Settings > Agents > View Details. You won't have to reconfigure existing flows if you have successfully reinstalled the agent.
I deleted my agent from Zoho Flow's settings page. Can I undo this?
No. You will need to create a new agent, then install it on your machine with the newly generated installation key.
Do I need to start the agent manually after system reboot?
Yes.
In Windows:
In Windows, you can start the agent by executing startagent.bat script available in the directory you've installed the agent ({installed location}\FlowAgent\bin) using the command prompt.
In Mac and Linux:
In Mac and Linux, you can start the agent by executing startagent.sh script available in the directory you've installed the agent ({installed location}/FlowAgent/bin) using terminal and run sh startagent.sh
Can I link multiple agents to the same Zoho account and the same machine?
Yes. You can link multiple agents to the same Zoho account, but different agents should be in different machines.
How do I manage all the agents I have created?
You can manage your agents by navigating to Settings > Agents.
Here you can perform actions such as rename, update, delete, enable/disable, and ping.
Why is my agent's status shown as inactive?
Your agent's status will be shown as in-active when it is unable to connect to Zoho Flow's servers. You can try the following steps to troubleshoot:
- Check your internet connectivity.
- Check whether the server or machine where the agent is installed is running properly.
- Restart the agent on your machine and try pinging it from agent settings.
- If none of these solves the issue, please contact Zoho Flow support.
Can I modify the proxy settings I've configured during the installation at a later time?
Yes. You'll need to navigate to the directory you've installed the agent and open the file named agent.properties (<installed location>/conf/agent/agent.properties). You can then modify the values in this file. Once you've configured your new proxy settings, restart the agent.
How do I prevent the agent from becoming inactive after I close the terminal in Linux /MAC?
You can overcome this by using nohup to start the agent as shown below. This prevents the agent from getting killed after closing the terminal.
nohup sh startagent.sh
How do I uninstall the agent and remove its files completely from my machine?
You can delete the files from the directory you've installed the agent, and the agent will be fully removed. The agent installation doesn't create any entries in the registry or leave leftover files in your system.
How do I solve the "The installation key is corrupted" error?
This error message means you might have entered the key incorrectly. You need to return to Zoho Flow, then copy the installation from the agent configuration window.
Next, you'll need to navigate to the directory on your machine where you've installed the agent, and open the file named install.txt from <installed location>/FlowAgent/conf/agent/. You can then enter the correct installation key against the AUTHTOKEN field in this file.
Why do I get the error 'SSL Exception occurred' while trying to connect an On-Prem app with Zoho Flow?
In Zoho Flow, importing an SSL certificate into the flow agent is necessary to establish a secure connection between Zoho Flow and the On-Prem app. Failing to do so will result in the following error:
Steps to import the SSL certificate:
Navigate to your On-Prem app's home page and click the View site information icon on the left side of the browser's address bar.
Click Connection is secure, then click the Show certificate icon.
In the certificate details page that appears, navigate to the Details tab.
Click the Export button at the bottom-right corner and save the certificate.
User Certificates
Starting from version 1.0.16, you can add the custom SSL certificates directly to the agent without using command-line tools. This simplifies connecting securely to external services.
For version 1.0.16 and later, follow the steps below to connect to your service.
- Navigate to <FLOW_AGENT_HOME>/user/certificates.
- Add your certificate files into this folder.
Note: Supported Certificate Formats The following file types are supported: .cert, .crt, .pem, .pfx, .p12, .cer
For users upgrading from earlier versions:
If you've previously added certificates using the KEYTOOL command:
- Your existing certificates will be migrated automatically.
- A file named: migratedCertificates.crt will be generated inside <FLOW_AGENT_HOME>/user/certificates and no additional action is required unless you want to add new certificates.
7. After restarting the agent, try connecting the On-Prem app with Zoho Flow.
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
Common problems
This guide will help you quickly resolve issues for yourself. You don't need to contact support every time you run into a roadblock while creating flows. We've compiled a list of the most common problems you might face and provided solutions for ...Data mapping
Introduction Data mapping is using the variables of a trigger or action as input for the next steps of the flow. It lets you decide how data should be organized when the flow is processing. With mapped data you can create a consistent flow of ...Rerun
Zoho Flow allows for executions to be rerun based on the type of error that caused failure. There are two types of reruns: Auto rerun - For executions failed due to Zoho Flow's internal errors or API errors from the apps that you have used in your ...Calendly
What is Calendly? Calendly is a customizable scheduling app that works on all devices. With features like time zone detection, round robin meeting allocation, and calendar integration, you can simplify the scheduling process. How to connect your ...Schedule trigger
A schedule trigger starts your flow at a specific time or at regular intervals. Unlike app triggers, which depend on events in applications, schedule triggers run based on time. You can use schedule triggers to automate tasks that need to run ...
New to Zoho LandingPage?
Zoho LandingPage Resources