How to Set Up Ranorex Studio: Admin vs Non-Admin Installation

Ranorex Studio can be installed in two modes, depending on your permissions and the organization’s policies.
Understanding the difference helps ensure that you get the right level of functionality for your testing needs

Admin Installation Setup

What You Get

• Full Ranorex features
• Can test any application (including system apps)
• Debugging tools work
• Can test mobile apps
• Can automate Windows system dialogs

Setup Steps

1. Right-click the Ranorex installer and select Run as administrator.
2. Follow the installation wizard
3. After installation, launch Ranorex Studio by right-clicking the icon and selecting Run as administrator.
4. Accept any Windows security prompts

When to Use Admin

• You need full Ranorex functionality (debugging, system-level testing, mobile testing)
• Testing applications that require administrator permissions

Non-Admin Installation Setup

What You Get

• Basic Ranorex testing features
• Record, playback, and run desktop application tests

Limitations

• Debugger unavailable
• Cannot test admin-level or mobile apps
• No mobile app testing
• Limited access to system dialogs

Setup Steps

1. Double-click the Ranorex installer (normal install)
2. Follow the installation wizard
3. Launch Ranorex Studio normally, no admin rights required

When to Use Non-Admin

• Your company's security policies prevent admin access
• You only test regular desktop applications
• You don't require debugging features 
• Basic test automation is sufficient

Quick Decision Guide

Troubleshooting Tips

If Non-Admin Installation Isn’t Working

• Check application permissions: Some applications under test may require administrator rights.

• Match permission levels: Ensure both Ranorex Studio and the application under test are running with the same privilege level.

• Registry access: Certain Ranorex features require registry access, which is only available with administrator privileges.

If Admin Installation Has Issues

• Always launch as administrator: Confirm that Ranorex Studio is consistently started using Run as administrator.

• Review UAC settings: Windows User Account Control (UAC) can block elevated permissions, adjust settings if necessary.

• Verify user privileges: Make sure your Windows account has administrator rights before installing or launching Ranorex Studio.

Ranorex Installation Blockers & Solutions

1. Permission & UAC Issues

Problem: "Elevated Permission Required" Pop-up

What it looks like: "The Process to debug runs with higher Privilege. Ranorex Studio needs to be restarted as Administrator."

Solutions

• Option 1: Right-click Ranorex Studio Run as administrator
• Option 2: Turn off UAC in Windows (not recommended for security)
• Option 3: Turn off debugging mode if you don't need it

Problem: UAC Blocks Installation

What it looks like: Windows blocks the installer or asks for admin password

Solutions

• Use the setup.exe file (not just the .msi)
• Right-click installer and select Run as administrator
• Temporarily lower UAC settings during install
• Contact IT department for installation assistance

2. Visual Studio Build Tools Conflicts

Problem: MSBuild Version Errors

What it looks like: "MSBuild 15.1.0 Install error with Ranorex 10.5.x"

Solutions

1. Uninstall conflicting Visual Studio Build Tools:
   • Go to Control Panel and select Programs
   • Remove old Visual Studio Build Tools
   • Let Ranorex installer add the correct version
2. Assembly Loading Issues: "Could not load file or assembly 'System.Memory, Version=4.0.1"
   • Reinstall Ranorex completely
   • Use setup.exe (not .msi) for full installation

3. Plugin & Loading Errors

Problem: "Failed to load default plugins"

What it looks like: "Failed to load default plugins. Please reinstall Ranorex."

Solutions

1. Clean Reinstall
   • Uninstall Ranorex
   • Delete %ProgramData%\{most recent Ranorex Version}
   • Use setup.exe to reinstall (not .msi)
2. Assembly Loading Issues
   • Check Ranorex logs at: %userprofile%\Documents\Ranorex\Logs
   • Contact support if errors persist

4. Company Security Restrictions

Problem: IT Policies Block Installation

What it looks like: Installation fails, access denied, or security software blocks it

Solutions:

• Work with IT Department
  • Request software approval through official channels
  • Provide Ranorex security documentation
  • Ask for temporary admin rights for installation
• Alternative Approaches
  • Use Ranorex on a development/test machine with fewer restrictions
  • Request IT to install Ranorex for you
  • Use non-admin installation if policies allow

5. Windows Security Features

Problem: "This app has been blocked for your protection"

What it looks like: Windows SmartScreen blocks the installer

Solutions

1. Click More info > Run anyway
2. Download from official Ranorex website only
3. Temporarily disable Windows Defender SmartScreen
4. Right-click the installer, select Properties, and click Unblock

Problem: Antivirus Software Interference

What it looks like: Installation fails or Ranorex won't start

Solutions

• Add Ranorex folders to antivirus exclusions
• Temporarily disable real-time scanning during install
• Whitelist Ranorex executables in security software

6. Network & Firewall Issues

Problem: Installation Downloads Fail

What it looks like: Setup can't download required components

Solutions

• Use offline installer (setup.exe with all components)
• Check corporate firewall settings
• Install on machine with internet access, then copy

Problem: License Activation Issues

Solutions:

• Ensure internet connectivity for license validation
• Check if company firewall blocks license servers
• Use offline activation if available

Quick Troubleshooting Checklist

Before Installing

• Download from the official Ranorex website
• Use setup.exe (full installer)
• Have admin rights or IT support ready
• If allowed, temporarily disable antivirus during install

If Installation Fails

1. Review Windows Event Logs for detailed error messages
2. Clean uninstall any previous Ranorex versions
3. Delete leftover folders: %ProgramData%\{current Ranorex Version}\
4. Restart computer before retrying
5. Try compatibility mode (Windows 7/8) if on newer Windows

After Installation 

• First launch with Run as administrator.
• Confirm the debugger works (requires admin rights).
• Create a simple recording to validate the setup.

Contact Support

Collect these before contacting support

• Exact error messages (screenshots)
• Windows version/build number and Ranorex version
• Company security software details
• Log files from %userprofile%\Documents\Ranorex\Logs

Contact support if

• Multiple solutions didn’t resolve the issue.
• You’re in a complex enterprise/network environment.
• Licensing/activation problems persist.