Breadcrumbs

Leapwork Platform

All three components of the Leapwork Platform Edition can be installed on the following versions of Windows:

  • Window 7 (Service Pack 1)*

  • Windows 8.0 + 8.1

  • Windows 10

  • Windows 11

  • Windows Server 2008 R2

  • Windows Server 2012

  • Windows Server 2012 R2

  • Windows Server 2016

  • Windows Server 2019

  • Windows Server 2022

  • Windows Server 2025

Notes:

  • You may experience performance challenges if you run complex automation flows on Windows 7, due to the operating system’s low memory constraints.

  • The Leapwork Platform edition utilizes the onboard SQLite database.

image-20260302-185254.png

Studio

The studio should be installed on the user’s workstation hence its configuration remains the same for Platform and Enterprise editions. The studio is comparable to a normal Office installation, so, in most cases, no special configuration is required. The minimum hardware configuration requirements are:

  • 8 GB RAM, 16 GB is recommended.

  • Intel i5 CPU.

  • 100 GB SSD-based internal storage.

  • A wired internet connection.

Controller

The Controller is the central hub in the Leapwork system and needs to be configured to accommodate the workload. The workload depends on various factors.

  • The number of automation flows.

  • The complexity and duration of automation flows.

  • The frequency of automation flow execution.

The recommendation is to start with a standard server configuration and monitor the Controller machine's memory usage, I/O activity, CPU usage, etc. The user can then down/upgrade the machine as required. A standard server configuration could be:

  • 16 GB RAM.

  • 4-8 cores.

  • Flexible and fast disc system (SSD, SAN, or similar. 500 GB to begin with).

The Controller can run on both physical and virtual servers. If you want to install all components on one machine, the following hardware configuration is required:

  • 16 GB RAM

  • 4-8 cores

  • 500 GB SSD

Agent

The Agent is used for executing automation flows. Whilst deploying the Agent in the Data Center, it may not be possible to obtain a Windows desktop version. Therefore, the Agent will also run on a Windows Server with Desktop Experience enabled. The Server is installed on a Windows server. Here is how to choose the configuration for the Agent machine:

  • Simulating applications for an end-user:
    In this case, the machine should be as similar as possible to the end-user's machine. This will increase the reliability of the automation flows. However, we recommend that the CPU has at least two cores.
    The recommended hardware configuration, in this case, would be: 

    • 8 GB RAM as a minimum; 16 GB is recommended.

    • Intel i5 CPU in a physical machine. In the case of a virtual machine CPU, there should be at least two cores. 

    • SSD-based internal storage.
       

  • Running automation flows in parallel:
    In the case of executing web automation flows, it is possible to set up an environment that points to a Selenium Grid. Selenium Grid allows multiple browsers to run web automation flows in parallel on the same machine. The more powerful the machine, the more browsers can run in parallel.
    In this case, a recommended hardware configuration (assuming 4 parallel browser executions) would be as follows:

    • 16 GB RAM.

    • 4-8 cores.

    • Flexible and fast disc system (SSD, SAN, or similar. 100 GB to start with).

Getting Ready for Installation 

Download Leapwork 

  • Download the latest version of the Leapwork from the Leapwork release page. 

  • Keep the downloaded copy of the installer file in all on-prem/remote machines where the Leapwork components installation is to be performed.

.NET Framework 

  • Leapwork uses different .NET versions depending on the product version and components being installed. 

    • .NET Framework 4.8 is a prerequisite for Leapwork and comes pre-packaged with Windows. For earlier versions, such as 2025.2, .NET Framework 4.8 may need to be downloaded manually from the Microsoft website if it is not already available on the machine. 
       

    • Starting with version 2025.2, Leapwork automatically installs .NET 6 as part of the installation process when required (for Fusion components only). 
       

    • From version 2025.3 onward, Leapwork automatically installs .NET 8 as part of the installation, removing the need for manual installation of newer .NET versions. 

    Always follow the installer guidance for your specific Leapwork version to ensure the correct .NET components are installed. 

Access Required to Perform Installation

  • Ensure all local admin rights are available on the controller, agent, and studio machines.

  • Ensure availability of access and authentication information like hostname/IP/credentials for connection to the on-prem/remote machines.

  • Application under test should be accessible from the Agent.

Port and Firewall Opening 

  • Open ports 9000 & 9001 on the controller machine.

  • Open port 6777 on all the agent machines. See article: Firewall and port settings before you install Leapwork.

  • Static IP Address or Unique Machine name for the controller machine. 

Installation Guide

To get an overview of the components of the Leapwork Platform Automation edition, see Architecture Overview.

Leapwork License Credentials

Notes:

  • Make sure you have credentials to log in to the Leapwork license engine. 

  • Contact your customer success manager if you don’t have one.

  1. Upgrade the .NET Framework to the latest version.

  2. Make sure you have credentials to log in to the Leapwork license engine.  

  3. Download the latest version of Leapwork. MSI file from the CP download  page on all machines where it is going to be installed.  

Note: The same MSI installer is used to install the Leapwork Controller, Studio, and Agents. 

Controller Installation  

  1. Open the MSI file location and double-click the .msi-file to start the installation. The first screen will display the version number. 

image-20260212-082539.png

  1. Click the Next button to begin the installation. 

  2. Read the end user agreement tick “I accept the terms in the license agreement” checkbox. 

  3. Click the Next button if you agree. 

image-20260212-082559.png

  1. Choose Automation Controller and deselect another two, you can keep studio if you want to keep in controller machine, but we do not recommend having agent installed on controller machine. 

image-20260212-082623.png

  1. Select the second radio button on the screen “I have license key”. Next, click on the "Get a License key" This will take you to the Leapwork license page.

Note: You can obtaiin the license key from the Customer Portal.

image-20260303-072335.png

  1. Click the Next button.  

  2. Enter the port codes for the automation controller and the automation controller API.  

image-20260212-082655.png

Controller Port 

The Studio and the Controller always communicate using internal API calls, and this requires the use of a TCP port. The default is port 9000, which you can change to any other port number that is not in use by other software on your computer.  

Controller API Port 

For any integration effort, access Leapwork open REST API using the default port number 9001, which you can change to any other port number that is not in use by other software on your computer.  

Note: Unless it is necessary for any reason, we do not recommend changing either the Controller or Controller API port numbers.


  1. Specify the paths for both assets and video. 

image-20260303-072439.png


WARNING: SAVE THE DATABASE ENCRYPTION KEY. It protects the database files created during the upgrade and enables the Controller to access them. The key is necessary if the Controller needs to be moved to a new machine or to restore the Leapwork system. Store the key in a secure and safe place.


  1. Specify a password for the default user Admin. This user is required for the first login to the Leapwork Studio after installation. 

image-20260303-072801.png


  1. Click Next on final warning screen to start the installation process.

image-20260212-082728.png

  1. Click the Finish button to complete the installation process. 

image-20260212-082753.png

  1. Click the Yes button to restart your system.  

image-20260212-082822.png

Studio Installation  

  1. Open the MSI file location and double-click the .msi-file to start the installation. The first screen will display the version number and ensure that the downloaded version fits your computer.

    image-20260303-073447.png


  1. Click Next to begin the installation.

  2. Read the end user agreement and select I accept the terms in the license agreement checkbox.

    image-20260303-073515.png


  1. Click Next button if you agree.

  2. Choose Automation Studio and deselect other two, you can keep Agent if you want to keep in same machine, but we do not recommend having agent installed on studio machine.

    image-20260303-073604.png

  3. Click Install to start the installation process.

    image-20260303-073750.png


  1. Click Continue to start the IE Addon installation.

    image-20260303-074005.png


  1. Click the Finish button to complete the installation process. 

image-20260212-082753.png

  1. Click the Yes button to restart your system.  

image-20260212-082822.png

Configuring Studio 

  1. Open Leapwork.

  2. Login into Leapwork Studio.

    image-20260303-074115.png


  1. Click on Select Controller button to select the correct controller in your organization. 

    image-20260303-074213.png

  2. Click on the Select controller dropdown to find and select your controller.

Note: If you can’t fine the name of controller by default then you can type it manually on the same dropdown control.

  1. Change the port number of controller if you have changed it during controller installation.

  2. Check the Web socket protocol as it is enables faster communication between Studio, Controller and Agent machines.

  3. Connect button will enable, click Connect. 

This will take you back to Leapwork Studio Authentication Window. To logging into Leapwork for the first time, you need to use your admin credentials in the Leapwork Studio Authentication Window.

image-20260303-074610.png


Agent Installation  

  1. Open the MSI file location and double-click the .msi-file to start the installation. The first screen will display the version number and ensure that the downloaded version fits your computer. 

  2. Click the Next button to begin the installation. 

image-20260212-083408.png

  1. Read the end user agreement tick “I accept the terms in the license agreement” checkbox. 

  2. Click the Next button if you agree. 

image-20260212-083430.png

  1. Choose Automation Agent and deselect another two, we do not recommend having Studio or controller installed on Agent machine. 

image-20260212-083514.png

  1. The configuration screen contains several settings that you can modify before completing the installation.  


Port: Automation flows run in the Agent, which communicates with the Studio and Controller over a closed remote-control protocol on a configurable TCP port (default: 6777).  You can change it to any unused port on the computer. 

Note: We recommend keeping the default Controller, Controller API, and Agent ports unless a change is necessary. 

Windows login: Agents includes a strong security feature to automate logging in and out of Windows.  

  • You don’t need to be logged into the machine to run a flow. Leapwork can log in on your behalf. 

  • You can also test single sign-on between Windows and any other application that uses the same credentials. 

To use your Windows credentials when configuring the Agent, you need to select Windows login. 

Agent password: In case you do not want to use windows login feature, then you should use the Agent password to secure your agents. Because the Agent uses a remote-control protocol, we advise that you set up a password to prevent unauthorized parties from connecting to it. 


Add exceptions for the Agent in Windows Firewall: A check in this box will direct the installation process to add a rule to the Windows Firewall to permit all incoming connections to the Agent. 


  1. Click the Next button after choosing your desired configuration.  

image-20260212-083548.png

  1. Check Enable Selenium Manager to auto-download browser drivers if you want Leapwork Studio to automatically download the matching browser drivers from the internet during runs. Otherwise, leave it unchecked to use the packaged drivers installed locally.

    image-20260313-152704.png

  2. Click the Install button to start the installation process.  

image-20260212-083607.png
image-20260212-083647.png

  1. Click the Finish button to complete the installation. 

image-20260212-083720.png


  1. To configure the Agent, go to the Studio machine and complete the configuration using Leapwork Studio.  

image-20260212-083751.png

For step-by-step instructions, see the article on configuring an Agent after installation. 

For any clarification, please contact on  Priority Support.