Documentation Index

Fetch the complete documentation index at: https://support.controlup.com/llms.txt

Use this file to discover all available pages before exploring further.

Deploy ControlUp for Apps on Windows

Prev Next
Before You Begin
  • The first time you open ControlUp for Apps, a setup wizard walks you through the deployment steps. Follow the instructions in the wizard or use this article to deploy ControlUp for Apps on Windows devices.

  • For macOS deployment instructions, see Deploy ControlUp for Apps on macOS.

ControlUp for Apps collects web application data from supported devices using the following components, which you can deploy directly from ControlUp:

  • ControlUp for Apps module: An add-on for the ControlUp for Desktops Agent that runs on the device.
  • ControlUp for Apps browser extension: Required for capturing web application usage and experience metrics from supported browsers.
    You can configure deployment rules by version, device group, and device tag. This lets you use different deployment settings for different sets of Windows devices.

Prerequisites

Read ControlUp for Apps Overview for prerequisites.

Deployment Instructions

To access deployment settings, go to Settings > Applications.
AccessApplicationsSettings.png

How Deployment Rules Work

You can add deployment rules to control which module version or browser extension settings apply to different devices.
Rules are evaluated from top to bottom:

  • The first rule a device matches is the only rule applied to that device.
  • Rules do not stack.
  • Place specific, limited-scope rules at the top and broader fallback rules below them.

Deploy the ControlUp for Apps Module

  1. Select the Deployment tab.
  2. Add or edit a deployment rule.
  3. Set Platform to Windows.
  4. In Version, select the module version to deploy.
  5. Select the target device groups or device tags. To learn how to create and manage them, see Organize Devices with Groups and Tags.
  6. Click Apply.
    The selected version is installed on Windows devices that match the selected device groups or device tags.
    Recommendation: To install the module on all your Windows devices and automatically keep it updated, select Latest GA version and target All device groups / All device tags.

Deploy the ControlUp for Apps Browser Extension

Under the Extensions tab, configure how the browser extension is deployed. The extension is installed only on devices that already have the ControlUp for Apps module installed. You can configure:

  • Browser extension deployment: Choose to deploy the extension either from the ControlUp CDN or from the official Chrome and Edge web stores. If you want to handle deployment through GPO, select Do not install, and read below to learn how to configure your GPO.
    • Deployment from the web store requires ControlUp for Apps module version 1.3 or higher. Devices running an older version always use ControlUp's CDN for extension deployment, regardless of how you configure this setting. Read the module deployment section above to learn how to ensure you are running the latest module version.
    • The browser extension is unlisted on the web stores. It can't be found via manual search. It can be deployed only through the ControlUp UI or GPO.
  • Device group and tag targets: The selected deployment option is applied to devices that match the selected device groups or device tags.
  • Browsers: Select which browsers to install the extension on.
    Extension UI
    The extension UI is an optional feature that allows end users to view their own page load metrics by clicking the extension icon. Choose to allow this for all devices, certain devices in specific groups or with specific tags, or do not allow.
    Browser extension UI displaying page load metrics.
Version Compatibility Warning

Extension deployment settings require ControlUp for Desktops version 2.17.7+ and ControlUp for Apps module version 1.2.x+.
If devices are running older versions:

  • The top-most rule always applies regardless of targeting scope.
  • The extension will be installed on all browsers regardless of your selection.

Manually Deploy Extensions With GPO

If you prefer to manage extensions using a group policy instead of allowing ControlUp to handle the deployment, set the extension deployment settings in ControlUp to Do not install to prevent ControlUp from interfering with your group policy.
To install the extension from ControlUp's CDN, use the following extension ID and update URL:

  • Microsoft Edge: jmnkfnngldhhdkggfgemlkckmphhnojp;https://downloads.sip.controlup.com/appdx/latest/appdx_edge.xml
  • Google Chrome: fbmmpaeakganhhofacjdciocgnbclbcl;https://downloads.sip.controlup.com/appdx/latest/appdx_chrome.xml
    To install the extension directly from the Chrome/Edge web stores, use the following extension ID and update URL:
  • Microsoft Edge: dhinjceeijmmnbppipomdhbcpcjndlip;https://edge.microsoft.com/extensionwebstorebase/v1/crx
  • Google Chrome: inoojfkadjhokmpdpednfbokjdangaep;https://clients2.google.com/service/update2/crx
    Read Microsoft's documentation or Google's documentation to learn how to force install extensions using a group policy.

Troubleshooting

Our ControlUp Tester tool includes a dedicated diagnostics and troubleshooting module for ControlUp for Apps. Download and run it to solve installation, configuration, or connectivity problems.
You can also verify the connection between the browser extension and the ControlUp for Apps module directly from the extension UI. Online indicates a successful connection.
Extension UI connected