After the user signs in to the client, tools are available to view connection status and perform diagnostic tasks. You can also see which entitlements are assigned to a user from the admin UI in the user's Session Details.
The Troubleshooting user and device access section covers how to resolve networking problems when users cannot connect to Controllers or Gateways.
The header provides access to messages and the menu. Below the header is the connection status, and below that are the app shortcuts.
App shortcuts
The main window displays any entitlements published as app shortcuts.
App shortcuts placed in groups appear first.
Right-click (or long-press) to see information about an app shortcut. From here, you can pin frequently used shortcuts. Shortcut Details provides more information including the app shortcut link, required user interactions, and a link to the Site details.
For more details about using shortcut URLs, see Configuring entitlements.
.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A49%3A49Z&se=2026-11-21T22%3A01%3A49Z&sr=b&sp=r&sig=hWY%2FE0Q%2BjYbZo8lwKD5VWlYK0mTCK12Dry0RopON0nc%3D)
.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A49%3A49Z&se=2026-11-21T22%3A01%3A49Z&sr=b&sp=r&sig=rYJ3x9zEwkidkMn9POXJAqgQbrG0KrkYNUjnuNaKXRw%3D)
Menu
The menu provides useful tools. Advanced provides more information about the status of the client.
(1).png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A49%3A49Z&se=2026-11-21T22%3A01%3A49Z&sr=b&sp=r&sig=iWTfm5CJJimfq9CXOMSqFzEJS0r3CazSVtknccnLIAo%3D)
Session Info
Session Info displays connection information and the status of Ringfence and Device Proxy.
Sites
Sites shows the status of Site connections. A green circle indicates a full connection.
Click (or long-press) on a site to see information about it. Site Details provides more information including the Gateway the client is using and the traffic mode.
.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A49%3A49Z&se=2026-11-21T22%3A01%3A49Z&sr=b&sp=r&sig=Qo3lgyMXjw2yfcpBHIhcpaL22%2Fb6atjmtuMSXqwZClM%3D)
Entitlements
Entitlements shows a searchable list of all current entitlements, including the Site, actions, and conditions for each.
.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A49%3A49Z&se=2026-11-21T22%3A01%3A49Z&sr=b&sp=r&sig=H0hGbSJEdpae94CmMhhMH3gU55WJetbFydVGVAog%2B2Y%3D)
Download logs
Download logs lets you download log files from within the client.
For desktop clients, a zip file is downloaded containing the past 30 days of logs.
For mobile clients, the current day's log file is downloaded.
(1).png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A49%3A49Z&se=2026-11-21T22%3A01%3A49Z&sr=b&sp=r&sig=9fpyFFvbDQ4RUP%2BfYKGDLf0psuhmYNHQ4nqUwdoxp7M%3D)
The logs typically contain three types of information: system, driver, and application. System logs help diagnose problems by providing information about the system, its settings, and settings relating to the client.
The administrator can also download logs for an individual user from the Active Sessions page.
Log bundles are the preferred way to collect logs. You can download log bundles through the client or the admin UI. The client stores its logs in multiple directories, and log bundles also collect system information essential for troubleshooting. If these methods are unavailable, or you need to access the logs directly, see the location of the logs for each client type.
Client status file
When a desktop client connects, it creates a JSON file named driver.status that contains the client’s connection state. at the following locations:
macOS and Linux:
/var/log/appgate/driver.statusWindows:
%PROGRAMDATA%\appgate\driver.status
The file exists only while the client is connecting and when it is connected. The file is not available before the connection is initia