This guide provides the steps to download and install Ranorex Studio using the setup wizard.
Before beginning the installation, ensure the environment meets the following requirements:
- System Requirements: Review the Hardware Requirements and Software Requirements pages for compatible Operating Systems, hardware specifications, and required software frameworks.
- Account Permissions: Installation may require administrator privileges on the target machine. For more information, refer to Admin vs Non-Admin installation.
-
Visual Studio Build Tools (MSBuild): If Visual Studio Build Tools (MSBuild) is not installed, the Ranorex installer attempts to download it from Microsoft during setup. On offline machines, install Visual Studio Build Tools before running the Ranorex installer. Otherwise, the installation cannot be completed successfully.
- If multiple MSBuild versions are installed, Ranorex uses the latest available version automatically.
-
However, if only MSBuild 18 is installed and the configuration file is still set to version 17, Ranorex may not detect MSBuild correctly. This can prevent project creation or builds from working as expected.
To resolve this issue, update the configuration file as follows:
<add key="MSBuildVersion" value="18" />After saving the change, restart Ranorex Studio.
Note: Download the free trial to start exploring Ranorex Studio. To receive the download link, enter your name, company name, and a valid business email address.
Install Ranorex Studio
- Download the Ranorex Studio installation file from the link you receive in your email.
- If the machine lacks necessary components (such as specific .NET Framework versions), run the prerequisites application to install them.
-
Launch the installation setup wizard and click Next to proceed through the welcome screen.
-
Select the checkbox to accept the terms in the License Agreement and click Next.
-
Specify where to install Ranorex Studio. Click Change... if you need to select a different installation directory. Otherwise, click Next.
-
The Custom Setup screen allows you to choose which components to install. Select all features to ensure full functionality and then click Next.
- Click Install. Once the progress bar reaches completion, click Finish.
- The installation progress bar starts. Once it's finished, please click Next.
After the installation finishes, the Welcome to Ranorex Studio evaluation dialog displays. Follow the prompts to activate a trial or install a purchased license. For more information, see Ranorex Licenses and Licensing.
Note: The installer automatically creates a Ranorex Studio shortcut on your desktop for quick access.
Open Ranorex Studio
To open the application:
- Open the Windows Start menu.
- Search and select the Ranorex Studio program icon.
If you start Ranorex Studio for the first time or do not have any existing projects, the start page opens with the solution wizard. This wizard guides you through the process of creating a solution for a specific testing goal. Select File > New > Solution Wizard from the main menu to manually open the solution wizard.