How can we help?

Articles in this section

See more

Installing the Desktop Tray Application

Jeff
  • Updated

The Desktop Tray Application is an effective method to deploy CloudRadial via a program that users can access straight from their desktop.

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

Downloading the Desktop Application

Create your custom installer with white-labeled branding to add further value to your Partners.

To do so:

  1. Navigate to Partner > Settings
  2. Select Desktop Application (on the right, under the Configuration column).
    • If this is your first time building the application, you will need to use the Settings button at the top right to build your installer package. 

                                   

  3. Once the installer package has been built, you can select the button Download Installer to download a copy of the .EXE file.

Please note that you can also change the branding at any time by selecting Settings and re-applying changes as necessary. Note that:

  • You will need to select the Rebuild Installer option under the dialogue box to re-build the .EXE file with your updated branding.
  • You will also need to redeploy the app to see changes in effect.

Desktop Application Installation Best Practices

For a Single User Installation

For individual installations or small deployments:

  1. Navigate to Partner > Settings
  2. Select Desktop Application (under the Configuration column)
  3. Click Download Installer to obtain the latest .EXE file
  4. Distribute the installer to end users for manual installation

Users can run the installer with standard administrative privileges

For RMM-Based Deployment (Recommended for MSPs)

For automated deployment across multiple endpoints using your Remote Monitoring and Management (RMM) platform:

Step 1: Download and Store the Installer

  1. Download the latest version of the desktop application from your Partner portal
  2. Store the .EXE file in a centralized repository accessible by your RMM system, such as:
    • Your RMM's script repository or file share
    • A network file share (UNC path)
    • Cloud storage with direct download links
    • Your internal software deployment server

Step 2: Configure RMM Deployment

  1. Create a new software deployment package in your RMM platform
  2. Point the package to your stored .EXE file location
  3. Configure the installation command for silent deployment:
    • ClientPortal.exe /verysilent
  4. Set deployment targets (specific clients, groups, or endpoints)
  5. Schedule deployment during maintenance windows if preferred

Optional Prerequisites Check

Before deploying, ensure your RMM script checks for:

  • .NET Framework 4.6.2 or greater (required for operation)
  • Administrative privileges for installation
  • Available disk space

Version Management Best Practices

Important: As of July 29th, 2025, CloudRadial no longer provides CDN downloads due to security updates. Partners must now download and manage installer versions independently.

When application updates are released:

  1. Download the latest version immediately upon notification
  2. Test the new version in your lab environment before widespread deployment
  3. Update your repository with the new installer file
  4. Modify your RMM deployment package to reference the updated installer
  5. Deploy to production endpoints according to your change management process
  6. Archive previous versions for rollback purposes if needed

You can view the complete change log of desktop app versions here for reference when managing updates.

Additional Options for Desktop App Deployment

The following options are available to assist in your deployment and installation of the desktop application.

Silent Install

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

ClientPortal.exe /verysilent

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 aren't expecting issues. 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 an RMM script, test for and install .NET as required. You can download the latest version here:

Uninstalling the Desktop Tray Application

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.

FAQs About the Desktop Application

What platform is the CloudRadial Desktop Application built on?

  • 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.

Is the auto-update of the Desktop Application available?

  • Auto-update of the desktop application is not available. Because this application is intended to run on the client-facing side of MSP businesses, clients must approve of the installation, which can cause confusion at best and, at worst, false security concerns (as in, users may ask - what was that pop-up asking me to update this app?

Related articles

Comments

0 comments

Article is closed for comments.