Choose a startup mode based on whether and how the Application Workspace Launcher should be visible when it's started by the ShellAPI at device startup or user login.
| Startup Mode | Description |
|---|---|
| Background (default) | In Background mode, the Agent and UserHost are fully initialised, but the user does not see the Application Workspace Launcher unless they open it intentionally later. The login of the user can be triggered. The tray icon is available and displays a context menu. This is the default startup behaviour and is recommended for most environments, including device‑centric and automated deployments. |
| Normal | In Normal mode, the Application Workspace Launcher starts at device startup or user login, and logs the user in immediately. This mode is most suitable for traditional desktop environments where users expect the Launcher to be visible after signing in. NOTE: Normal mode can significantly reduce startup duration. |
| Hidden | In Hidden mode, the Agent and UserHost are fully initialised. The UserHost does not attempt to connect to a zone until UserHost.exe is run again by the user or by a script. The user does not see the Launcher and is not logged in automatically. The tray icon is available but does not display a context menu. This mode is useful in scenarios where Application Workspace must be running, but user interaction should be deferred or tightly controlled, such as in zero-trust environments. |
Example
{
"launcher": {
"enabled": true,
"start": "Disabled",
"close": true
},
"userHostStartupOperatingMode": "Hidden",
"zone": "https://company.liquit.com/"
}