This guide aims to walk you through the installation and activation of the Leapwork trial version, ensuring you can efficiently set up and use its components from the very first step.
To get an overview of the components of the Leapwork Automation Platform, see this article.
Installation Guide
To start the installation, follow the steps below:
-
Download the latest release from the Customer Portal.
-
Save and transfer the file to the local system.
-
Navigate to the MSI file location and double-click the .msi file to start installation.
-
Click the Next button to start the installation.
-
Read the end user agreement, select the I accept the terms in the license agreement checkbox, then click the Next button.
-
Click the dropdown menu to select components to install, then click the Next button. Refer to Working with Leapwork for details.
Note: For trial, keep the default selection of all three components.
The Configuration screen contains settings for multiple components. You can modify these later in the configuration files for each component: studio\studio.config, controller\controller.config, and agent\agent.config. These files are in the installation directory: C:\program files\LEAPWORK.
For fresh installation, click New Configuration, then click the Next button.
-
Enter the License Key and click the Next button.
Note: You can obtain the license key from the Customer Portal.
8. Continue with Locally hosted MS SQL and click on Next.
-
Enter the port codes for the automation controller and the automation controller API.
Controller Port: Studio and the Controller make API calls using a TCP port. The default is port 9000, you can change to any other port number that is not in use by other software on your computer.
Controller API Port: For integration, access Leapwork's open REST API using the port number set here. The default port is 9001. You can change to any other port number that is not in use by other software on your computer.
Note: We do not recommend changing the Controller, Controller API, or Agent port numbers.
Add Exceptions for the Controller in Windows Firewall: Select this option to add a rule to the Windows Firewall to permit all incoming connections to the Controller.
Note: The password is optional. The Leapwork Automation Platform is used in corporate and secured test networks.
-
Specify the paths for both assets and video.
Path to Assets: This is the path to the file system folder which contains the encrypted SQLite database files holding all Leapwork assets, automation flows, schedules, and run results. -
Enter the password and click next.
-
Enter the password you will use to log in to the Controller after installation.
-
Enter the password and click Next.
Adjust settings on the configuration screen before installation. Leapwork Agents can log into Windows automatically, so users do not need to be logged in to run a flow. They also support testing Single Sign-on between Windows and other applications.
-
In the screen below, Agent Port: Automation flows run within the Agent, which communicates with Studio and the Controller through a closed remote-control protocol on a specified TCP port. The default port is 6777, but you can change it to any unused port.
Agent Login Methods:
A. 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.
B. 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.
-
Let’s select Windows login method and click on Next button.
-
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, then click the Next button.
Clicking on the Next button will take you to the Step 15.
Do not change the controller, controller API, or agent port numbers unless necessary.
If you select Agent Password, you will see the screen below: Set a password to prevent unauthorized access since the Agent uses a remote-control protocol.
-
Click the Next button to continue.
-
Click on Install button.
The installation is in progress.
The installation is successfully done.
Activation Guide
If you have the software installed but need to activate it, follow these steps:
-
After installing all Leapwork components, start Leapwork Studio. The Controller broadcasts its IP address, so Studio usually detects it on first start.
-
Log in as admin. Studio prompts you to enter the license key.
-
To get License key, click the Customer Portal link.
-
Copy the License Key.
-
Paste the License Key in the provided field and click Validate button.
-
After a successful activation, click the Continue button.
Note: If you encounter any problems with the login, please contact Leapwork Customer Support.