How to obtain TruGrid Desktop Connector Logs

Like most other software, Windows connector writes down most of the thigns that are happening with and to it. It generally produces two types of logs.


Native Connector Logs capture what happens on the user-facing side of the connection -- login attempts, authentication results, and the errors displayed to the end user. Start here when a user reports a specific error message or can't log in.


Headless Connector Logs capture what happens behind the scenes -- the relay tunnel lifecycle, data flow between the client and the target host, and connection resets with directional detail (whether the drop came from the server side or the client side).


Tools to parse, interpret and send the logs to support automatically are available as a part of the TruGrid SecureRDP Toolkit.


Start here when connections drop silently, succeed intermittently, or when native logs show a generic error that doesn't explain the cause.

In short: native logs tell you what the user saw, headless logs tell you why.

On Windows Devices


TIP: You can use the Run menu in Windows and type in %localappdata% and it will immediately take you to the AppData Local folder.


The Windows Native & Headless Connector logs can, as of May 2026, and with the introduction of the Machine Wide enabled Windows connector, be found on the following path:

C:\Users\$(user)\AppData\Local\TruGrid\Logs


As of this update, and since a single device can have both User and Machine wide based installations present at the same time, the logs distinct between them with the following formats:


Machine wide install:


C:\Users\$(user)\AppData\Local\TruGrid\m_win_headless_logs_*


User context install:


C:\Users\$(user)\AppData\Local\TruGrid\n_win_headless_logs_*
For older versions the location is: C:\Users$(user)\AppData\Roaming\TruGrid Connector


On Mac Devices


The Mac Connector logs can be found at the following location:


The script to parse the logs is available as a part of the TruGrid SecureRDP Mac Toolkit.


/Users/username/.config/TruGrid/Logs


For Mac users:

  1. Please open Finder
  2. At the top left of the screen Click Go
  3. Select Go to Folder
  4. Follow the path /Users/{username}/.config/TruGrid/Logs (where {username} is your computer folder user name)

Updated on: 18/06/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!