--- source_url: "https://docs.leapwork.com/leapwork-studio/latest/working-with-leapwork/agents-overview" title: "Agents Overview | Leapwork Docs" mirrored_at: 2026-08-14T03:37:23.021Z host: docs.leapwork.com cited_in_42a: true mirror_canonical: "https://index.42a.ai/docs.leapwork.com/leapwork-studio/latest/working-with-leapwork/agents-overview" --- > **Original source:** https://docs.leapwork.com/leapwork-studio/latest/working-with-leapwork/agents-overview An agent is a machine or cloud environment where Leapwork runs automation flows. This importamt component allows you to run flows on remote systems, in parallel, or in different configurations, without interrupting your main workspace. ![Architecure\_overview\_image\_1-20260526-112536.png](https://docs.leapwork.com/__attachments/a_cae0b4394c53589407d301b84338bb189c35c34f4846b87f04552f5c733674ac/Architecure_overview_image_1-20260526-112536.png?cb=fa66ec55c0cc3fe0175745405bd33b49) You can assign agents when setting up schedules or when running flows in preview mode. This article explains how to create and use agents in Leapwork. It covers the two main types of Leapwork Agents, remote and cloud-based, and the supported third-party web execution providers. You’ll also learn how to assign, reassign, and manage agents effectively across your automation setup. ## Agent Overview From the main menu, you can now manage Agents and see which schedules they’re used in, along with their current status. The **Agents** section displays all Agents, their associated schedules and the following details: - Run List - Schedule - Status - Last Run - Agents Once you click on any Agent, the Agent overview list is filtered out. It can be filtered using the filter drop-down menu: ![image-png-Jun-18-2023-11-08-11-3275-AM.png?width=792&height=141&name=image-png-Jun-18-2023-11-08-11-3275-AM.png](https://docs.leapwork.com/__attachments/a_61ab9dcbf37494add2a3e3bd7472a86ae677ab77a510309c41bfe319c2bbebf4/image-png-Jun-18-2023-11-08-11-3275-AM.png%3Fwidth=792&height=141&name=image-png-Jun-18-2023-11-08-11-3275-AM.png?cb=827d5bba94e7724e4f853ba6aa1f45a6) ## Create an Agent To configure a Leapwork Agent, follow these steps: 1. Open Leapwork Flow and navigate to the **Agents**  section. 2. Click on the **New** button from the Agents menu. 3. Select the appropriate Agent type and configure the necessary settings. 4. Save the configuration and test the connection. For detailed setup instructions, refer to each Agent type below. ![image-20260526-112734.png](https://docs.leapwork.com/__attachments/a_6cf47bc03e7f2dc7f794e98ea9692ff7a2451c68b47044fa420e0c21133b6b97/image-20260526-112734.png?cb=322684aba43c474ad7d8e9ff82330731) **Note**: The screenshots on this page use the **Elegance Design**, introduced in **2025.3**. If you are using an earlier version, your layout may look different. ## Agent Types ### Remote Agent The Remote Agent is Leapwork’s proprietary runtime agent for distributed automation execution. It supports **Web, Desktop UI, and Virtual Desktop automation**. **Setup Steps:** 1. Select **Remote Agent** from the **Agent type** drop-down. 2. Enter a unique **Agent name** (e.g., “_Local Agent_”). 3. Enter a description if needed. This field is optional and can be used to keep some notes/description about the Agent 4. Specify the **hostname**. **Note:** If the Agent is installed on the same machine as Leapwork Flow, use localhost. Otherwise, specify the **IP address, machine name, or DNS name** of the remote machine. 5. Set the **port**. **Note:** Default port is **6777**. Confirm that this port is open on the firewall to ensure connectivity. 6. Select **Authentication** Method: - **Windows login** – Requires manual login with Windows credentials. - **Windows login - auto** – Allows predefined automation users (preferably service accounts) to automatically log in during execution. - **Password** – The Agent is protected by a password known only to team members. 7. Choose the **screen resolution**. 8. To record only the selected display, even if multiple screens are available on the agent, check **Lock recording on selected screen**. 9. Select the desired **display** for execution. 10. Select the **SAP System Logon**. 11. Select the **Green Screen application** type from the available options. 12. Select the **proxy configuration** method from the following options: - **No proxy** – The agent will not use a proxy. - **Automatic detection** – The agent will automatically detect proxy settings. - **Automatic from URL** – The agent will retrieve proxy settings from a specified URL. - **Manual settings** – Manually configure the proxy settings. 13. To automatically lock the session after disconnecting from the agent, check **Lock session after disconnecting from Agent**. 14. Test the connection 15. Save the configuration. ![image-20260526-113046.png](https://docs.leapwork.com/__attachments/a_5ba519eb3f605d285f62f0e82ff09c5e3da2168d698ac02f484613819d3a6880/image-20260526-113046.png?cb=e1ca0d026f44777218c3b84ad476b1c5) If the Agent is configured correctly, Leapwork will open a terminal window displaying the host computer's desktop. At this point, you can log in with the Windows account that the Agent should use. This session remains active until the Agent machine is restarted. Save the configuration to complete the setup. For more details, see Remote Agents documentation. ### Leapwork Cloud Agent Leapwork offers **Cloud Agents** as part of its fully managed cloud-based infrastructure. Cloud Agents provide a scalable execution environment without requiring on-premise infrastructure and support web automation. Cloud Agents support web automation and OCR-based automation using Image and Text Recognition, plus Mouse and Keyboard actions. Mobile automation can be executed using supported third-party cloud testing providers such as LambdaTest, BrowserStack, and Sauce Labs, when those integrations are configured. **Setup Steps:** To set up a Leapwork Cloud agent, follow these steps: 1. Request **Cloud Agent activation** via the [Customer Portal](https://docs.leapwork.com/leapwork-flow/latest/customer-portal). - A **Customer Success Manager (CSM)** will provide the necessary details once the request is approved. 2. Enter a **title** for the Cloud Agent. 3. Enter a **description** if needed. 4. Select the **agent type** from the ‘Type’ dropdown and choose **Leapwork Cloud Agent**. 5. Select the **specific Cloud Agent** assigned to the customer from the ‘Leapwork Cloud Agent’ dropdown. 6. Select the **screen resolution** for execution. 7. Test the connection. 8. Save the configuration. ![Leapwork-cloud-agent](https://docs.leapwork.com/__attachments/a_9a1ef389438f94f6c70201abc21ac46400694f29b7ea2e32477673a0f50e1f7e/Leapwork-cloud-agent.png%3Fwidth=300&height=344&name=Leapwork-cloud-agent.png?cb=04496bbd361df1748f31c66f2efc334c) ### Selenium Grid Leapwork supports integration with Selenium Grid, allowing users to execute **web automation tests** across multiple browsers and environments in a distributed setup. **Selenium Grid acts as a proxy**, distributing automation execution to multiple Selenium nodes instead of using a Leapwork Agent. **Note:** Users must configure their own Selenium Grid before adding the agent in Leapwork. [VIDEO TUTORIAL: Selenium Grid](https://www.leapwork.com/services/learning-center/selenium-grid) **Setup Steps:** To set up a Selenium Grid agent, follow these steps: 1. Enter a **title** for the Selenium Grid Agent. 2. Enter a **description** if needed. 3. Enter the **hostname** as the IP address, machine name, or DNS name of the Selenium Grid Hub. 4. Enter the **port number**, which should match the port specified in the Selenium Grid configuration (_default is 4444_). 5. Enter the **platform name** if execution is required on a specific platform available in Selenium Grid; otherwise, leave it blank. 6. Select the **browser** from the available dropdown list: - Chrome - Firefox - Edge - Internet Explorer (IE) - Safari 7. Enter the **browser version** if execution requires a specific browser version. If left blank, Selenium Grid will use the latest available version. **Note:** To test a specific version, ensure it is available on Selenium Grid. If not, leave the field blank to run tests on any available version of the selected browser. 8. Enter the **user profile** to be used for browser execution. 9. Select the **Chrome emulation device type** from the available list, which includes desktop and various smartphone models. 10. Select the **browser size**, which determines the screen resolution for execution. 11. Select the **proxy configuration** method: - No proxy - Automatic detection - Automatic from URL - Manual settings 12. Test the connection. 13. Save the configuration. ![image-png-Mar-07-2023-04-40-05-6477-AM.png?width=297&height=598&name=image-png-Mar-07-2023-04-40-05-6477-AM.png](https://docs.leapwork.com/__attachments/a_d14682efae9d878a15645f6becdf51ed17adc0f1da647e245dbc318edcd03023/image-png-Mar-07-2023-04-40-05-6477-AM.png%3Fwidth=297&height=598&name=image-png-Mar-07-2023-04-40-05-6477-AM.png?cb=f41cea5c466a28082c066a75e128d7b2) For more details, see [Selenium Grid Documentation](https://www.seleniumhq.org/docs/07_selenium_grid.jsp). ### Sauce Labs Leapwork supports integration with Sauce Labs, a cloud-based testing platform that allows you to run automated **web and mobile tests** across a wide variety of **browsers, operating systems, and devices**. This agent type is ideal when you want to **validate cross-browser and cross-platform compatibility** without maintaining your own infrastructure. Use it to execute automation flows on real browsers and devices in the cloud—especially useful when testing environments are not available locally. **Note:** You must have a valid Sauce Labs account and access credentials before proceeding with the setup. [VIDEO TUTORIAL: Learn how to set up an Agent for Sauce Labs.](https://www.leapwork.com/services/learning-center/scheduling-web-cases) **Setup Steps:** To set up a Sauce Labs agent, follow these steps: 1. Enter a **title** for the Sauce Labs Agent. 2. Enter a **description** if needed. 3. Select the **Agent Type** as _Web Only – Sauce Labs_. 4. Enter your **Sauce Labs username**. 5. Enter your **Sauce Labs access key**. 6. Select the **platform & operating system** from the available list. 7. Select the **platform version**. 8. Select the **browser** from the available dropdown list. 9. Enter the **browser version**, or leave it blank to use the latest available version. **Note:** In case version info is not available, **latest** should be chosen as the option. 10. Select the **screen resolution** for test execution. 11. Test the connection. If the Agent is set up correctly, Leapwork displays a green **Successfully connected** message. 12. Save the configuration. ![image-png-Mar-07-2023-04-38-29-2550-AM.png?width=301&height=458&name=image-png-Mar-07-2023-04-38-29-2550-AM.png](https://docs.leapwork.com/__attachments/a_7c556362a398cd0ad850fa9531a41a03d192f8f70b68c86d4dc802e142fd5ffe/image-png-Mar-07-2023-04-38-29-2550-AM.png%3Fwidth=301&height=458&name=image-png-Mar-07-2023-04-38-29-2550-AM.png?cb=1fee1025547b47063fdb4f1a25ad31e7)  For more details, see [Sauce Labs Documentation](https://docs.saucelabs.com/overview/). ### Browser Stack Leapwork supports integration with BrowserStack, a cloud-based testing platform that enables automated testing across a wide range of **browsers, operating systems, and mobile devices**. This agent is ideal when you need to **run web tests on real devices and browsers in the cloud**, especially for validating **cross-browser compatibility** and ensuring coverage on systems not available in your local setup. **Note:** You must have an active BrowserStack account and access credentials before configuring this agent. [Video tutorial: Learn how to set up an Agent for BrowserStack.](https://www.leapwork.com/services/learning-center/scheduling-web-cases) **Setup Steps:** To set up a BrowserStack agent, follow these steps: 1. Enter a **title** for the BrowserStack Agent. 2. Enter a **description** if needed. 3. Select the **Agent Type** as _Web Only – Browser Stack_. 4. Enter your **BrowserStack username**. 5. Enter your **BrowserStack access key**. 6. Select the **platform & operating system** from the available list. 7. Select the **platform version**. 8. Select the **browser** from the available dropdown list: 9. Enter the **browser version**, or leave it blank to use the latest available version. **Note:** In case version info is not available, **latest** should be chosen as the option. 10. Select the **Chrome emulation device** if needed, choosing from desktop or a wide variety of smartphones. 11. Enable **Local identifier** and enter a value in the input field to test a locally hosted application. **Note:** This setup uses BrowserStack Local to test internal or private servers, as well as public URLs, through the BrowserStack cloud infrastructure. It supports firewalls, proxies, and Active Directory. 12. Select the **screen resolution** for test execution. 13. Choose the **browser console logs** level from the dropdown. 14. Test the connection. If the Agent is set up correctly, Leapwork displays a green **Successfully connected** message. 15. Save the configuration. ![image-png-Mar-07-2023-04-37-23-3594-AM.png?width=319&height=572&name=image-png-Mar-07-2023-04-37-23-3594-AM.png](https://docs.leapwork.com/__attachments/a_2b8a0a0748e601a552b72c9ba2a03d727cbb0e3c7dd2343e5d86a020908f32d0/image-png-Mar-07-2023-04-37-23-3594-AM.png%3Fwidth=319&height=572&name=image-png-Mar-07-2023-04-37-23-3594-AM.png?cb=170fca1091ff8903d655520f0be7dd45) For more details, see [Browser Stack Documentation](https://docs.saucelabs.com/). ### GridLastic Leapwork supports integration with Gridlastic, a cloud-based Selenium Grid service that enables cross-browser testing across different operating systems and browsers, without needing to maintain your own Selenium infrastructure. This agent is ideal when you want to **run web automation flows in a cloud-hosted Selenium environment** while keeping full control over your configurations and test distributions across multiple browsers and OS combinations. **Note:** You must have an active Gridlastic account and access credentials before configuring this agent. **Setup Steps:** To set up a Gridlastic agent, follow these steps: 1. Enter a **title** for the Gridlastic Agent. 2. Enter a **description** if needed. 3. Select the **Agent Type** as _Web Only – Gridlastic_. 4. Enter your **Gridlastic subdomain**. 5. Enter the **port number** (default is 80, but it can be modified if required). 6. Enter your **Hub username**. 7. Enter your **Hub password**. 8. Select the **platform & operating system** from the available list. 9. Select the **platform version** to define where the test will be executed. 10. Select the **browser** from the available dropdown list. 11. Enter the **browser version**, or leave it blank to use the latest available version. 12. Select the **Chrome emulation device** if needed, choosing from desktop or a wide variety of smartphones. 13. Select the **screen resolution** to define how the browser is displayed during test execution. 14. Test the connection. If the Agent is set up correctly, Leapwork displays a green **Successfully connected** message. 15. Save the configuration. ![image-png-Mar-07-2023-04-34-12-5674-AM.png?width=330&height=626&name=image-png-Mar-07-2023-04-34-12-5674-AM.png](https://docs.leapwork.com/__attachments/a_ca63a193ce09b7011de7b5fb0e4d68affcd181feb487450b9abe41c826ff2166/image-png-Mar-07-2023-04-34-12-5674-AM.png%3Fwidth=330&height=626&name=image-png-Mar-07-2023-04-34-12-5674-AM.png?cb=2faac4f94698bfde0eecb18dcbc3b67c) For more information, refer to [Gridlastic’s official documentation](https://www.gridlastic.com/documentation.html). ### LambdaTest Leapwork supports integration with LambdaTest, a cloud-based cross-browser testing platform that allows you to automate web application testing across more than 3,000 browsers, operating systems, and real devices. This agent is ideal when you need to **validate how your web application behaves across a broad range of browsers and OS combinations**, without managing your own test infrastructure. **Note:** You must have an active LambdaTest account and access credentials before configuring this agent. **Setup Steps:** To set up a Gridlastic agent, follow these steps: 1. Enter a **title** for the LambdaTest Agent. 2. Enter a **description** if needed. 3. Select the **Agent Type** as _Web Only – LambdaTest_.Enter the **hostname** (IP address, machine name, or DNS name of the LambdaTest hub). 4. Enter the **port number** (default is 80, but can be modified if needed). 5. Enter your **LambdaTest username**.Enter your **LambdaTest access key**. 6. Select the **platform & operating system** from the available list. 7. Select the **platform version**. 8. Enter the **browser version**, or leave it blank to use the latest available version. 9. Select the **screen resolution** to define how the browser is displayed during execution. 10. Enter the **custom capabilities** in JSON format if required. **Note:** Custom capabilities allow you to define advanced execution settings, such as browser options or test metadata, supported by LambdaTest. 11. Test the connection. If the Agent is set up correctly, Leapwork displays a green **Successfully connected** message. 12. Save the configuration. ![Agent-lambdatest](https://docs.leapwork.com/__attachments/a_08b992dc47ff96f82706fe4dbe35d033f8ddf07128b7fa61687d3355df25e316/Agent-lambdatest.png%3Fwidth=332&height=624&name=Agent-lambdatest.png?cb=4a0c16636e80a1b004063703d415ba08) ## Using Agents Use configured Agents in [schedules](https://docs.leapwork.com/leapwork-flow/latest/working-with-leapwork/run-lists/schedules) and [preview runs](https://docs.leapwork.com/leapwork-flow/latest/working-with-leapwork/designing-automation-flows#Steps-to-Design-a-Flow) within the Leapwork Automation Platform. ## Reassign Agents Between Teams Administrators can reassign agents between [teams](https://docs.leapwork.com/leapwork-flow/latest/working-with-leapwork/teams) directly from the Agents view, as long as the agent is not currently assigned to a schedule, runlist, or test. This enables more flexible resource management in multi-team environments. ![Untitled design (7).jpg](https://docs.leapwork.com/__attachments/a_a76cabdac1ba3c0190d81d9cc29e9cdac9bf5e76b52aae68d0f369615adc546f/Untitled%20design%20\(7\).jpg?cb=3a7951fac3bf92c5f0794c2858a62cb1) **Note:** This feature is available starting from **Release 2025.2.0,** and only for users with admin rights under licenses that support multiple teams. ## Additional Resources For further reference and in-depth guidance, please see: - [Agents FAQ](https://docs.leapwork.com/faq/latest/leapwork-flow-faq/agent-faq) - [Agents Troubleshooting](https://docs.leapwork.com/troubleshooting/latest/leapwork-flow-troubleshooting/agent-troubleshooting)