Agent FAQ

What Windows authentication types does the Remote Agent support?

Leapwork supports three Windows authentication methods to connect to a VM running the Remote Agent service:

• Windows login: Requires a Windows username and password. Use whoami in Command Prompt to find the username. Add a Login block in your automation flow to simulate logging in.

• Windows login – Auto: Automatically logs in with credentials set in the Agent Connection settings. No Login block is needed in your flow.

• Password: Uses the password set during agent installation. No username required.
  

  

All three methods work on VMs without an active user session, starting from Windows 7 SP1. This simplifies automation on virtual machines and SSO testing.

Granting local log-in rights to a non-admin user

If a non-admin user needs access to the agent machine, grant them Allow log on locally rights:

1. Open the Run dialog (Windows + R), type gpedit.msc, and press Enter.

2. Navigate to:
   Local Computer Policy > Computer Configuration > Windows Settings > Security Settings > Local Policies > User Rights Assignment
   

   

3. Right-click Allow log on locally and select Properties.
   

   

4. Click Add User or Group, add the user, and apply the changes.
   

   

5. Restart the machine.

How do I run test cases on a remote computer?

To run tests remotely, install the Leapwork Agent on one or more dedicated machines. This offloads test execution from your local computer and allows for parallel test runs across multiple machines.

• Before installing, review the Leapwork Architecture Overview. Then follow the steps in Agent Installation on Windows.

  After installation, register the agent in the Environment section so the Controller can manage it.

How do I set up Selenium Grid (general)?

Selenium Grid lets you run tests in parallel across different browsers and operating systems, speeding up execution and supporting multi-browser environments.

1. Download and Prepare Files

• Download the latest Selenium Server JAR from Selenium HQ.

• Download and extract Grid_Setup.zip, and move the folder to C:\Grid Setup.

• Copy the downloaded .jar file into the C:\Grid Setup folder.

2. Set Up the Hub

• Edit hub.bat to ensure the .jar filename matches the one you downloaded.
  

  

• The hub uses hubconfig.json to load default configurations.
  

  

• Run hub.bat. Verify the hub is running by visiting:
  http://localhost:4444/grid/console
  

  

3. Set Up the Node

• You can use the same or a separate machine.

• Update driver files in C:\Grid Setup with the latest versions for Chrome, Firefox, Edge, and IE.
  

  

• Edit node.json to define:

  • "browserName" (e.g. "chrome")

  • "maxInstances"

  • "hub" URL (use localhost:4444 or hub IP if remote)
    

    

• Edit node.bat to reflect the correct .jar file name.
  

  

• Run node.bat. Once the node connects, it appears in the Grid Console.
  

  

4. Connect Leapwork

Configure Leapwork to run tests on your grid using the integration article. You can scale by adding more nodes on different machines.

How do I configure Selenium Grid on macOS (Safari/Chrome/Firefox)?

Selenium Grid allows you to run tests in parallel across multiple browsers and OSs, helping reduce test execution time.

1. Download Required Files

• Download Selenium Server JAR from Selenium HQ.

• Download latest ChromeDriver and GeckoDriver (for Firefox).

• Safari's driver is pre-installed at /usr/bin/safaridriver (macOS 10+).

2. Driver Configuration

Move the drivers to /usr/local/bin:

mv chromedriver /usr/local/bin  
mv geckodriver /usr/local/bin  

3. Safari Setup

• Enable Develop menu via Safari Preferences > Advanced.

• From the Develop menu, enable Allow Remote Automation.

• Run once to authorise:

safaridriver --enable

4. Set Up Selenium Grid

• Download and extract SeleniumGrid.zip to your Desktop.

• Rename your .jar file to selenium-server-standalone.jar and place it in the folder.

• Make the script executable:

chmod u+x ~/Desktop/Selenium\ Grid/gridSetup.command

• Double-click gridSetup.command to launch both Hub and Node.

Verify the grid at: http://localhost:4444/grid/console

5. Connect to Leapwork

Once the grid is running, configure Leapwork to run your tests using the related setup article.

How do I connect Leapwork with the Gridlastic cloud agent (Selenium 4)?

Leapwork integrates with cloud providers like Gridlastic, which offers on-demand Selenium Grid infrastructure. This allows you to run Leapwork flows across different devices, browsers, and operating systems.

Follow these steps to connect Leapwork:

1. Log in to your Gridlastic dashboard.
   

   

2. Go to Grid Configurations in the left panel.

3. From the Selenium Version dropdown, select 4.7.0.
   

   

4. Click Launch Grid. The grid will generate:

   • Subdomain

   • Username

   • Password / Access Key

5. In Leapwork Agent settings, create a new Gridlastic agent using these details.

How do I change the Agent port?

By default, the Leapwork Agent uses port 6777. If another application is using it, the Agent service may fail to start. You can manually change the port without reinstalling:

1. Stop the Agent service

   • Press Win+R, type services.msc, and press Enter.

   • Find Leapwork Agent, right-click, and select Stop.
     

     

2. Edit the configuration

   • Go to C:\Program Files\Leapwork\Agent.

   • Open agent.config as Administrator.

   • Change the value of AgentPort, save, and close.
     

     

3. Restart the Agent service

   • Return to Services, right-click Leapwork Agent, and select Start.

4. Update your firewall

   • Allow inbound traffic on the new TCP port.

5. Test connection

   • Use Leapwork Studio to confirm the Agent is reachable.
     

     

How can I keep the Agent’s display resolution consistent?

Running tests at a fixed resolution can fail if the Agent’s display settings change. To keep resolution stable, follow these practices:

1. Use a dedicated service account

   • Avoid connecting multiple users to the same Agent.

   • Remote desktop sessions can change resolution or disrupt tests if closed mid-run.

2. Align resolution in Leapwork Studio

   • In Environment settings, ensure all users configure the same resolution (Native or a chosen fixed value).
     

     

3. Set resolution manually on the Agent machine

   • From Leapwork Environments, keep Screen Resolution as Native, then click Test connection.
     

     

   • On the Agent desktop:

     • Right-click → Display settings → Advanced display settings.

     • Select the required resolution → Apply → Confirm.
       

       

By following these steps and keeping accounts and configurations consistent, the Agent will run tests at a stable resolution.

How do I prevent the Agent machine from logging out or sleeping?

By default, Windows locks or sleeps after a set time. To keep the Agent active, follow these two steps:

1. Disable Power & Sleep Settings

Ensure the machine never locks or sleeps automatically:

If your organisation restricts these changes, host the Agent on a VM and adjust settings there.

2. Update Agent Configuration

Modify the Agent config file to keep the display active:

1. Stop Leapwork Agent from services.msc.

2. Open C:\Program Files\Leapwork\Agent\agent.config in Notepad (as Administrator).

3. Add:

   "KeepDisplayActive": true,
   

   
   

   

4. Save the file and restart the Agent service.

5. In Leapwork Studio, refresh Controller settings to apply changes.

With these adjustments, the Agent machine will stay awake and maintain its session for test execution.

Can Leapwork log in/out when the Agent’s screen is locked?

Leapwork supports two ways to log in and out of a locked Agent machine:

1. Windows Credential Provider

• Leapwork can log in on behalf of the user and support SSO testing.

• Add Login, Logout, or Lock blocks to your flows. For example, use a Login block at the start and a Logout block at the end of automation.
  

  

• Agent settings let you log in automatically or manually with a Windows account, and optionally lock the session after disconnect.

• Preconditions:

  • Install the latest Leapwork with Windows Credential Provider.

  • Select Windows login during Agent installation.
    

    

  • No one should be connected via Remote Desktop.

  • Restart the machine after installation.

• Works from Windows 7 SP1 onwards, even after reboot, without prior sessions.

2. Custom Blocks with Images and Text

• Create a Custom Remote Login Block:

  1. Lock the Agent machine.

  2. Capture a static element of the lock screen (e.g. Press Ctrl+Alt+Delete).

  3. Use a Type Text block to send Ctrl+Alt+Delete.

  4. Use Find Image + Click Position to select the user account.

  5. Type password and press Enter to log in.
     

     

• Add a similar Logout flow as the final step or case in your run list.

• The scheduler runs cases in order (top to bottom); reorder by drag and drop.

Why is the Preview environment empty over RDP on Windows 7/Server 2008 R2?

On Windows 7 SP1 and Windows Server 2008 R2, limitations in desktop duplication technology prevent Leapwork Studio features from working over Remote Desktop Connection. As a result, the preview environment appears blank.

• You can still run Leapwork Agent on these systems as a System Under Test, but Leapwork Studio cannot be used via RDP.

• Studio works under these conditions:

  • Windows 7 SP1 / Server 2008 R2 on a physical machine with a physical display.

  • Windows 7 SP1 / Server 2008 R2 with Leapwork Agent only as System Under Test.

  • Windows 8 or later: fully functional, including RDP.

How can we reset the Leapwork Agent password?

When installing the Leapwork Agent, you’re prompted to set a password for configuration security. If you later forget this password, you have three options:

1. Reinstall the Agent component and set a new password during installation.

2. Check Windows Registry (HKLM\\SOFTWARE\\LEAPWORK → AgentPassword). If the value is visible (not encrypted), you can retrieve it. If encrypted, this approach won’t work.
   

   

3. Clear the password in agent.config:

   • Stop the LEAPWORK Agent service.

   • Navigate to C:\Program Files\LEAPWORK\Agent and back up agent.config.

   • Remove the encrypted value under the Password field.
     

     

   • Save, restart the Agent service, then configure in Studio with a blank password.

If none of these work (for example, if the registry value is encrypted), reinstalling is the only supported way to reset the password. For special cases, contact Priority Support.