RPA Agent for Linux
What is an RPA Agent?
RPA agents are software programs that run on desktop machines to automate tasks. They are the core component of the RPA platform that executes automation actions. Every machine that needs to run automation requires an RPA agent. The agent connects the Zoho RPA server to the client machine and provides information about the machine's status, such as whether it is up and available to run bot executions. The agent also enables the server to send instructions on what needs to be done.
System Requirements
Supported Operating systems: Supported on Linux Ubuntu 20.04 LTS and later.
Minimum disk space: 512 MB
Minimum RAM: 512 MB
Create RPA Agent
Install RPA Agent
- Log in to your Zoho RPA account.
- In the Settings section, click Agents, then click Create Agent.
- Navigate to the Linux tab, then click the download link.
- Click Generate Key to generate a unique key for the new agent. In the pop-up window that appears, click Accept to continue.Note: The installation key can only be generated by either an admin or the owner of the organization. Once the key is generated, it will be available for the other users in the organization.
- Follow the on-screen instructions and run the agent.
- Once you've successfully set up the agent, click Next.
- Click Done.
Register Agent
- Enter the agent name in the Agent name field.
- Enter the agent key in the Agent key field.
- Click Register Agent.
- Switch to the browser window to confirm that your agent is created and registered.
If you're operating behind a firewall and encountering connectivity issues, learn more about the necessary domains to whitelist in Whitelist Domains for Firewall.
Configure Proxy Settings
To set proxy settings for the RPA agent on your client machine:
- Install the RPA agent.
- On the Register Window screen, click the Set Proxy button.
- You will be redirected to the Proxy Configuration screen.
- Enter the following information:
- Server
- Port
- Username (optional)
- Password (optional)
- Click Save.
To configure proxy settings for a previously registered agent:
- Right-click the gear icon on the RPA Agent interface and select Set proxy.
You will be redirected to the Proxy Configuration window screen. - Enter the proxy server settings and click Set proxy.
Unregister Agent
To unregister an agent:
- Right-click the gear icon on the RPA Agent interface and select Unregister Agent.
- Click Unregister to proceed.
Note: Unregistering an agent will abort all running RPA processes and exit the agent. You will need to manually start the agent again, if required.
Connect, Disconnect and Exit RPA Agent
You can connect, disconnect, and exit the RPA Agent from the RPA Agent interface
- To connect the agent to the RPA server: Right-click the gear icon and select Connect.
- To disconnect the agent from the server: Right-click the gear icon and select Disconnect.
- To check the agent Status: Right-click the gear icon and then select Status.
- To exit the RPA process: Right-click the gear icon on RPA Agent and select Exit.
Note: The Enable and Prevent screen lock options are not supported for Linux agents. Ensure your Linux screen is unlocked for automations to run correctly. Actions like Type Into and Hotkeys will fail if the screen is locked. Only Web automation actions are currently supported for Linux Agents.
Update RPA Agent
You have two options to keep your RPA agent up-to-date:
Manual update
You can update the agent whenever you are ready. You will receive a notification when a new version is available.
Auto update
When a new update is available, you will see a prompt asking you to update the agent. Selecting Remind me later will prompt you again in 30 minutes.
Minimum version and update requirements
If your RPA agent is below the minimum supported version, you will receive a prompt to update it. You need to ensure the agent is running with administrator privileges for the update to work. Updates can then proceed manually or automatically, depending on which setting is enabled.
Delete RPA Agent
To delete or remove the RPA agent:
1. Unregister Agent
To unregister an agent:
- Right-click the gear icon in the RPA agent interface and select Unregister Agent.
- Click Unregister to proceed.
Note: Unregistering an agent will abort all running RPA processes and exit the agent. You will need to manually start the agent again, if required.
2. Unins
tall Agent
To uninstall the Zoho RPA agent on your Linux machine, navigate to the installation directory of Zoho RPA and remove the application's folder. This action will remove the Zoho RPA agent from your machine.
3. Delete Agent
As the final step, you will need to delete the agent from your Zoho RPA organization. Here's how :
- Log in to your Zoho RPA account.
- Click Settings, then click Agents.
- Hover over the agent you want to delete, then click the bin icon to delete the agent.
If the RPA agent is currently used in any flow, you'll be prompted to remove it from those flows first. To do this, go to the respective flow, navigate to the builder screen, click Change agent and select a different agent. Once done, you can return here to delete the original agent.
Retrieving RPA Agent Logs for Support and Debugging
To help our support team debug your issue quickly, please locate and attach the following log file in your email to the support team.
On Linux, logs are stored in the hidden .ZohoRPA directory within your Home folder. To access your logs, follow these steps:
- Open your Home folder.
- Press Ctrl + H to reveal hidden folders.
- Open the .ZohoRPA directory and navigate to the logs folder.
- Locate the RPAAgentLog0.txt file and attach it to your email.
Note: If the issue has occurred multiple times, please include all log files from the directory (e.g., RPAAgentLog1.txt, RPAAgentLog2.txt, etc.) to help us debug the issue more effectively.
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
Introduction to Zoho RPA
What is RPA? Robotic Process Automation (RPA) is a software technology that automates business processes by deploying software robots to mimic human-like interactions on applications. RPA bots can interact with any application or system based on its ...RPA Agent for Windows
What is an RPA Agent? RPA agents are software programs that run on desktop machines to automate tasks. They are the core component of the RPA platform that executes automation actions. Every machine that needs to run automation requires an RPA agent. ...RPA Agent for Mac
What is an RPA Agent? RPA agents are software programs that run on desktop machines to automate tasks. They are the core component of the RPA platform that executes automation actions. Every machine that needs to run automation requires an RPA agent. ...RPA flow
What is an RPA flow? RPA flows are like processes or workflows that you can create to automate tasks. An RPA flow is made of a trigger and one or more actions. The trigger initiates the flow, and the actions are the tasks that are executed by the ...Manage RPA Agents
This page provides a central view for managing all RPA agents within your organization. Here, you can get a quick overview of each agent's status and key information. Agent Overview The following details are displayed for each installed agent in the ...
New to Zoho LandingPage?
Zoho LandingPage Resources