Configure Ranorex Agent | Ranorex
Help CenterUser GuideRanorex Studio advanced

Configure Ranorex Agent

Ranorex Agent’s window with opened main menu is shown in the following picture:

In the top right corner of the agent’s window, open the main menu to:

  • Change Display Name
    The agent’s display name is shown in the top left corner of the agent’s window and in the Remote Pad in Ranorex Studio. If you’ve changed the agent’s display name, all those, who have this agent in their Agent List, will have to remove the agent with the former display name from their list, and re-add it manually with the new display name.
  • Show Files…
    Opens the folder in the file system, which contains all data related to the agent.
  • Autostart at Logon
    Select to automatically start the Ranorex Agent after login into the machine.
  • Keep Session Active
    This setting makes sure that the user session keeps unlocked even if you close the remote session.

    For more information also consult the ⇢ Remote FAQ section.

Note icon


  • As the Keep Session Active mechanism will keep your remote machine unlocked even if you’ve disconnected your RDP session, an essential security mechanism is now disabled. Please be aware that your remote machine can now easily be accessed as the system security is disabled. We advise you to not store sensitive data on your remote machine.
  • When ending your active RDP session and switching to an unlocked remote session, the remote machine may change to a different screen resolution. This may happen in particular if your remote machine is a virtual machine. In this case, the default screen resolution of the virtual machine will likely be used. This may affect your tests.
  • Always on Top
    Check this option to show the agent’s window on top of all other windows.
  • Exit
    Select to shut down the agent and release the license. In the Remote Pad in Ranorex Studio, this agent will be displayed as not reachable.