Application Workspace Agent Bootstrapper 4.4

  • Published on Jan 23, 2026
  • 3 minute(s) read
Prev Next

Application Workspace Agent Bootstrapper is a tool that assists in installing or updating the Application Workspace Agent, and optionally in running a deployment after installation. It runs on both Windows and macOS platforms.
The bootstrapper can be downloaded from our Downloads page.

Overview

  • You can deploy an executable through Intune. if no certificate is needed and the Agent.json file configurations that cannot be set through the bootstrapper. The objects that you can configure in the command line are Zone, Registration, Deployments except for cancel, trigger, zoneTimeout
  • The Agent.json file is no longer required next to the bootstrapper before running.
  • XML configuration files are no longer supported.

Prerequisites

  • The bootstrapper requires Application Workspace Server and Agent 4.0 or greater.
  • Depending on the OS, the bootstrapper must be always executed with certain privileges:
    • Windows - Administrator privileges
    • MacOS - Root privileges

Stages chronology

  1. You specify the bootstrapper executable and the zone from where it will download the installer.

  2. It Initializes logger using provided log path or default path. The default path is the current working directory.

  3. It downloads the agent installer and runs it.

  4. It checks if running whether it is being run with administrative (Windows) or root (Linux/macOS) privileges. If not, it will display a message indicating that elevated permissions are required.

  5. Display help information if requested.

  6. It handles the uninstall.

    • macOS: The uninstall behaviour is the same as the preinstall script for the macOS installer. it unloads the UserHost for each logged in user, then it unloads the Agent launch daemon, then it deletes the Liquit.app and the config files remain on the system on purpose.
    • Windows: it checks multiple registry paths for 'Application Workspace Agent' to locate the uninstall command and run that command. If it's not found, it logs a warning.

  7. It handles the zone configuration.

  8. It handles device registration if you specified the necessary details in the command line before the bootstrapper was run.

  9. It writes the JSON file settings for the deployment configuration, if you specified --startDeployment or --startDeployment Dialog before the bootstrapper was run.

  10. It runs the installer. The Application Workspace service is started.

  11. It starts the deployment if you defined it previously.

  12. Exits automatically, indicating that all operations have finished successfully.

Return codes

The following return codes are displayed in the bootstrapper:

  • Success = 0
  • InsufficientPermissions = -1
  • PlatformNotSupported = -2
  • CriticalError = -3

Commands

General

--logPath "c:\install"

Specifies the directory where the log files will be placed. If you do not specify a path, the current working directory will be used.

--help

Lists the available commands with a short description of them.

--uninstall

Uninstalls the first Agent it can find in the registry.

--wait

Only exit when all tasks are finished (including deployment).

--zone "https://demo.liquit.com/"

Sets the zone property in the gent.json file to the specified value.

Device registration

--registrationType User

The type of registration to use. It can be: User, Credentials, Certificate or CertificateEnrollment. For more information, see Agent Configuration.

--registrationUsername exampleUser

When type key is set to "Credentials", this username is used to register this device.

--registrationPassword examplePassword

When type key is set to "Credentials", this password is used to register this device.

--certificate "c:\path\to\certificate"

Copies the specified certificate file to the Application Workspace data folder.

--certificateThumbprint "69f4db57b74e13415cd103323331d95022d840c1"

Writes the value to the Certificate Thumbprint field in the configuration file.

--certificateIssuer "Sectigo RSA Domain Validation Secure Server CA"

Writes the value to the Certificate Issuer field in the configuration file.

Downloading & installation

--forceDownload

Forces downloading the installer even if one is already present.

--downloadUrl "https://example.com/installer.msi"

Specifies the URL used for downloading resources.

Windows exclusive installation commands

--msiProperties "EXAMPLE_PROPERTY=1"

Specify properties that are passed along to the installer.
This command works only on Windows. See Universal Agent installation for more information about this command.

--skipOverride

Don't use the "OVERRIDE_CONFIG" flag when installing.
This command works only on Windows. See Universal Agent installation for more information about this command.

Deployment

--deviceDeployment

All actions are forced to run in the device context. If not specified, all actions run in the default context which is Device.

--deployment "DeploymentName or GUID"

Specify a deployment by name or GUID.

--startDeployment

Start the deployment without the deployment dialog.

--startDeploymentDialog

Start the deployment dialog.

--deploymentDialogTimeout 10

The number of seconds to wait for a deployment confirmation. If not specified or 0, it will wait indefinitely.

Examples

Run the boostrapper to download the agent installer from a designated zone and install it:

bootstrapper.exe --zone "https://demo.zone.com/"

Run the boostrapper to download the agent installer from a designated zone, install it and run a deployment:

bootstrapper.exe --zone "https://demo.zone.com/" --startDeployment --deployment "Deployment name"

bootstrapper.exe --zone "https://demo.zone.com/" --startDeployment --deployment "00000000-0000-0000-0000-000000000000"

Run the boostrapper to download the agent installer from a designated zone, install it and run a deployment GUI where you select the deployments:

bootstrapper.exe --zone "https://demo.zone.com/" --startDeploymentDialog