Installation Guide: Download and install - Platform Version of LEAPWORK – Knowledge Base

Installation Guide

PLEASE NOTE! If you are upgrading from a version prior to 2018.1.*, e.g. 2.5.*, please use the 2018.1 upgrade guide instead of this installation guide.

To get an overview of the components of the LEAPWORK Automation Platform, please visit the Architecture Overview.

To start the installation, do the following:

Download the new version from the download page.
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. Click 'Next' to begin the installation.

4. Choose which of the three components to install on the computer. Do this by clicking the drop arrows and choosing the appropriate option for each component.

5. The configuration screen contains properties used for one or more of the components. All settings can be changed afterwards in the config files for the individual components:

1. 1. ‘studio\studio.config’,
  2. ‘controller\controller.config’
  3. ‘agent\agent.config’.
    The files are in the installation directory – typically ‘c:\program files\LEAPWORK\’.

6. Select the second radio button on the screen, click "Get a License key" and log in with your LEAPWORK web credentials to generate your license.

7. To obtain the license key, click "Get a License Key" in the dialogue, which will open a browser and take you to account.leapwork.com. On account.leapwork.com you will have to log in using your e-mail and the password provided when signing up on leapwork.com:

In case you encounter problems with the login, please contact LEAPWORK Customer Success.

After successful login on leapwork.com, the license management page opens. This page contains a few different sections:

Get license key:

Use the form to generate a new license key by doing the following:

Select an active subscription
Select the kind of license to generate a license key for. It is possible to generate license keys for Agents only and add them to an existing Controller.
Specify the number of Agents to add to the license, unless the license type is 'Controller only'.
Click 'Get license key'
Copy the license key by clicking 'Copy license key'

Note: Please be sure to save the database encryption key, which is used to protect the database files created during the upgrade. This key enables the Controller to gain access to the database files. It’s also required if the Controller has to be moved to a new machine or in case a LEAPWORK system restore is needed. Save the key in a protected and safe place.

Path to assets. This is the path to the file system folder which contains the encrypted SQLite database files holding all LEAPWORK assets, including automation flows, schedules, and run results.

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. NOTE: Unless it is necessary for any particular reason, we do not recommend changing either the Controller, Controller API, or Agent port numbers.

Controller API port. For any integration effort, access LEAPWORK’s 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 particular reason, we do not recommend changing either the Controller, Controller API, or Agent port numbers.

Add exceptions for the Controller 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 Controller. NOTE: Because the LEAPWORK Automation Platform is also often used in secure corporate test networks, the password is optional.

2. Click “Next” on the configuration screen.

3. Specify a password for the default user (“Admin”). The “Admin” user is required for the first login to the LEAPWORK Studio after installation. Please note, that the password you enter for the admin user is securely located in your local installation only. LEAPWORK cannot assist in retrieving this password should you forget it.

4. Click “Next” on the configuration screen.

The configuration screen contains several settings that you can modify before completing the installation. By default, the Agent talks to the Controller over port 6777, but this can be changed if necessary. LEAPWORK Agents now include a strong security feature to automate logging in and out of Windows. A user is no longer required to be logged into their machine in order to run a flow. Instead, LEAPWORK can be set up to login on the user’s behalf. Users can also start testing single-sign on between Windows and any other application that reuse the same login credentials. The user has to choose Windows login to be able to use Windows credentials to configure the Agent, OR the user can choose the old way of setting a password. The password is left blank by default.

Agent port. Automation flows run in the Agent, which communicates with the Studio and Controller through a closed remote-control protocol on a specific TCP port. The default port is 6777, which you can change to any other port number not in use by other software on the computer. NOTE: Unless it is necessary for any particular reason, we do not recommend changing either the Controller, Controller API, or Agent port numbers.

Agent password. Because the Agent uses a remote-control protocol, we advise that you set a password to prevent unauthorized parties from connecting to it.
The settings explained

Please note: LEAPWORK Agent passwords will begin deprecation and should be removed from the product before the end of the year.

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.

5. When you are happy with the configuration, click “Next” to continue and then “Install” on the next screen: