Use Royal TSX with Advanced Server Access

Royal TSX is a Remote Desktop Protocol (RDP) client available for macOS. You can use Royal TSX to create RDP or Secure Shell (SSH) connections to servers enrolled with Advanced Server Access.

Before you begin

  • Download and install Royal TSX.
  • Install the following plugins from Royal TSX > Plugins:
    PluginDescription
    Remote Desktop (based on FreeRDP)Required for RDP connections
    Terminal (based on iTerm2)Required for SSH connections
    Web (based on Webkit)Required for connections from a dynamic folder

Connect to Windows servers with Royal TSX

Before you connect, you need to configure Advanced Server Access to use Royal TSX as the default RDP client. To do this, enter the following command:

sft config rdp.client royaltsx

After you set Royal TSX as the default client, enter the following command to connect:

sft rdp HOSTNAME

Create a dynamic folder for team servers

Dynamic folders allow Royal TSX to automatically add a list of servers that belong to a team. You can use this to start RDP and SSH sessions directly from Royal TSX.

  1. In Royal TSX, go to File > New Document.
  2. Right-click the new document and select Add > Dynamic Folder.
    The Dynamic Folder Settings window appears.
  3. Enter a name and description for the folder.
  4. Click Dynamic Folder Script.
  5. In the Interpreter dropdown, select Bash.
  6. Replace the default script with:

    sft list-servers-rjson

  7. Click Apply & Close.
  8. Right-click the dynamic folder and select Reload.
  9. If prompted for approval by Advanced Server Access, click Approve.

Royal TSX populates the folder with a list of available servers. To refresh this list, right-click the folder and select Reload.

Related topics