While configuring an on-premise app's trigger or action:

1. If you've already created an agent, select the agent from the on-prem agent dropdown.
   
   
   
   
2. If you haven't yet created an agent, click New.
3. Select the operating system of your machine, then click on the download link suitable for its architecture.
4. Click Generate Key to generate a unique key for the new agent. In the pop-up window that appears, click Accept to continue.
5. Follow the on-screen instructions provided for your selected operating system to install and run the agent.
6. Once you've successfully set up the agent, click Next.
7. Click Authorize.

Installing the agent in your system

For Windows:

1. From the agent download screen, download the agent installer for your system's architecture (32-bit or 64-bit). Copy the installation key.
2. Once downloaded, double-click the installer to start the installation.
3. When prompted, copy and paste your installation key into the installer.
4. Provide a name for the agent, then configure the proxy details, if needed. Click Next.
5. Choose the folder where the agent should be installed, then click Next.
6. Once the installation is finished, then click Done.
7. Return to the Zoho Flow browser window and click Next.

1. From the agent download screen, download the agent installer for your system's architecture (32-bit or 64-bit). Copy the installation key.
2. Open Command Prompt.
3. List the folder where the agent is downloaded by entering its path followed by '>dir'. For example, if the agent is downloaded to c:\Users\Administrator\Documents, then type in  c:\Users\Administrator\Documents>dir and press enter.
4. Press enter again, then enter start FlowAgent.exe
5. The installer will begin to install the agent. When prompted, enter the installation key that you copied earlier from the browser window running Zoho Flow. Provide a name for the agent.
6. Click Next.
7. Choose the folder where you want to install the agent. Click Next.
8. When the installation is complete, check the box that says Start Agent, then click Finish.
   

Note: Make sure that port 443 (HTTPS protocol) is enabled for outbound connections in your firewall. Learn how

For MacOS:

1. From the agent download screen, download the agent. Copy the installation key.
2. Navigate to the folder where the installer is downloaded, and extract the ZIP file named 'FlowAgent_mac.zip'.
3. Double-click FlowAgent.
4. You may receive the following warning:
5. You need to allow MacOS to open and execute the installation package.
6. Navigate to System Preferences > Security and Privacy. In the General tab, click Allow for Allow apps downloaded from: App store and Identified Developers.
7. If you're using MacOS Ventura, you might see a message that FlowAgent was blocked as it was not from an identified developer. Click Open Anyway, then click Open, and try installing again.
8. When prompted, copy and paste your installation key into the installer. Provide a name for the agent, then click Next.
9. Choose the folder where you want to install the agent. Click Next.
10. Configure the proxy server port details and credentials, if needed. Click Next.
11. Review the information, then click Install. 
12. Once the installation is complete, click Done.
13. Open Terminal, then enter <installed location>/FlowAgent/bin. 
14. Enter sh startagent.sh
15. Return to the browser window running Zoho Flow.

Note: Make sure that port 443 (HTTPS protocol) is enabled for outbound connections in your firewall. Learn how

For Linux:

1. From the agent download screen, download the agent. Copy the installation key.
2. Open Terminal.
3. Enter the path where the installer is downloaded.
4. Enter the command chmod 755 FlowAgent.bin to provide the necessary permissions to the installer.
   Note: This command provides the following permissions:
   > Can delete, rename, and add files into the directory.
   > Can change the file's content.
5. Run the installer by entering ./FlowAgent.bin
6. After extracting the components of the installer, the installation window will appear. When prompted, paste the installation key that was previously copied from Zoho Flow.
7. Once the installation is finished, return to Zoho Flow, then click Next.

1. From the agent download screen, download the agent. Copy the installation key.
2. Enter the path where the installer is saved.
3. Enter the command chmod 755 FlowAgent.bin to provide necessary permissions to the installer.
   Note: This command provides the following permissions:
   > Can delete, rename, and add files into the directory
   > Can change the file's content
4. Enter ./FlowAgent.bin to run the installer.
5. When prompted, enter the installation key. Provide a name for the agent. 
6. Enter the path where you'd like to install the agent.
7. Configure the proxy details, if needed.
8. Review the installation details, then press Enter to continue.
9. Once the installation is finished, return to Zoho Flow, then click Next.

Note: You need to make sure that port 443 (HTTPS protocol) is enabled for outbound connections in your firewall. Learn how

Enable ports in firewall 

You need to make sure that port 443 (HTTPS protocol) is enabled for outbound connections in your firewall. 

Restarting the agent

Updating the agent

1. Security enhancements
2. Additional support for new or updated applications
3. Bug fixes and patches
   

1. In the Settings section, navigate to Agents.
2. Click View Details adjacent to the required agent.
   
   
   
   
3. Toggle the auto-update switch to On.
   
   
   
   

Deleting the agent

Your agent might not be reachable due to reasons such as unavailability, crashes, or other issues. In that case, follow the steps below to delete your agent.

For windows

1. Go to the Control Panel, then click Uninstall or change a Program.
   
   
   
   

2. Right-click Zoho Flow On-Prem Agent and click Uninstall.

3. A pop up will appear to confirm removing all the folders. Click OK to proceed.
   

1. Navigate to the terminal and locate the folder where the agent is installed.
   
2. ​Type rm -rf FlowAgent to delete the agent.