Installing the Desktop Tray Application

For more information on the desktop application, see this article.

Download

Create your custom installer under Partner > Settings > Desktop Application (on the right, under Configuration). Then, download and save the EXE.

Silent Install

You can deploy the desktop application to your users remotely using the following command line:

ClientPortal.exe /verysilent

Disabling Auto-Update

If security is paramount, you can disable the auto-update capability with the install switch setting:

autoupdate=0

This function further secures the desktop application to disallow potential security vulnerabilities. It is not mandatory.

Enable Logging

To enable logging that can assist with program execution issues, add the install switch setting:

logging=true

This will generate two logs in the downloads folder, one for the program and one for the chromium browser.

Change Rendering Method

Prior to version 4 of the desktop, the default method of screen rendering was "offscreen" this maximized compatibility with older virtual environments. This method also disabled drag/drag functionality. Starting with version 4, the default method of screen rendering is now "hardware" which makes better use of the machine's graphics card and enables drag/drop features. To revert to the older method of screen rendering, add the install switch setting:

renderingMethod=offscreen

This option may help with certain virtual environments.

Trapping Error Alerts

When the desktop fails to load, it will typically fail silently so it won't throw odd errors to users who arent' expecting issues. In order to see these errors, add the install switch setting:

errorAlerts=true

Errors on startup should then be shown to users. You may want to use this in virtual environments where group policy settings may be interfering with the program's ability to create and run the chromium binaries required.

.NET Framework Required

.NET Framework 4.6.2 or greater is required for the agent to operate. Most PCs have .NET installed and updated by the operating system, but some servers may not have the latest version installed. If you are automating the deployment of the agent through a RMM script, test for and install .NET as required. You can download the latest version here:

https://www.microsoft.com/net/download/dotnet-framework-runtime

Uninstall

To uninstall the desktop application silently, use the command:

C:\Program Files (x86)\[Your Client Portal Directory]\unins000.exe /norestart /verysilent

The desktop application can also be removed using the Add or Remove Programs option in Windows. The program will be listed under the name of your portal.

Note

The client portal uses a distribution of the Chromium engine to render your portal in a desktop application. It is separate from any other Chrome or Chromium installations on the computer and cannot share information with other installs.