Windows App – Custom Location Installation

Windows App – Custom Location Installation

Our Windows app is available in 2 variants: our default Standard Installer (which you can download directly from our website or our web portal backend) or a Custom Installer that can be made available on request.

Our standard installer should suffice for most single-user desktop/laptop installations.

For more complex deployments involving shared desktop resources, automated fleet deployments, virtual machines, and the like, we have a Custom Installer option to help you confidently deploy our Windows app to your environment.

Standard vs Custom Installer

The Custom Installer executable MUST be executed as admin, or it might fail during setup.

FeatureStandard InstallerCustom Installer
Install path parameter
Not supported

-installDir "InstallPath"
required
User data directory parameter
-userDataDir "UserDataPath"
optional

-userDataDir "UserDataPath"
optional
Automatic app updates
Enabled

Disabled
Shortcut placement on desktopsPer-user desktop onlyPublic desktop shortcut for all user accounts
Admin privileges required
Per-user install

Must run as Admin
Re-install updates
User-by-user reinstall

Use same installDir path to update
Typical use caseStandard installsShared installations, machine-level deployments on shared desktop environments, eg, Citrix

Install Usage Examples

To help you deploy our app to your environment, here are some sample command syntax options for you to use in your deployment scripts.

Custom install

Folder> .\App.exe -customInstall -installDir "InstallPath"

Custom install with custom user data directory

Folder> .\App.exe -customInstall -installDir "InstallPath" -userDataDir "UserDataPath"

Standard install with custom user data directory

Folder> .\App.exe -userDataDir "UserDataPath"

Standard install

Folder> .\App.exe

Special Environment Scenarios

RDP (Remote Desktop) Environment

For these use cases, each user should install the app in their own AppData directory, as running multiple users from the same machine-level install will lead to conflicts or logouts.

When deploying to these environments, use the following command syntax in the command prompt or PowerShell.:

.\App.exe -customInstall -installDir "%USERPROFILE%\AppData\YourApp"

VM / Citrix or Shared Virtual Desktop

Install the app on the master image using installDir. Be sure to store user data on a network share so it can be accessed from any VM in the environment.

.\App.exe -customInstall -installDir "C:\AppPath" -userDataDir "\Fileserver\OrganizationAppUserData"

Conclusion

Use Standard Installer for user-per-account installs.

Use Custom Installer when you need:

  • machine-wide deployment
  • custom installation paths
  • shared user data folders on a central network location
  • disabled auto-updates
  • public desktop shortcut
    • Related Articles

    • Windows App Installations and Enterprise Deployments

      This guide outlines the system requirements, standard installation processes, and enterprise deployment guidelines for our Windows application. It also includes specific instructions for installing or upgrading to our latest 64-bit application. ...
    • Enabling GPS on Windows devices

      GPS/location functionality is provided using Windows Location Services, which must be enabled for the app to access these services. The link below describes how to configure Location Services on Windows 10: ...
    • Installing the app on Windows 7/8 (Legacy Support)

      This article details what you need to install to run our app on Windows 7/8 and some tips on troubleshooting issues you might encounter. These requirements apply exclusively to the installation of our app on Windows 7/8. If you’re using a more recent ...
    • How do I check and/or install .NET Framework for my Windows app?

      This article provides instructions on installing the prerequisite software necessary to run the app on Windows 10 or 11. Installing the app on Windows 7/8 (Legacy Support). To run our Windows app on your device, you must install .NET Framework ...
    • My Windows app shortcut no longer works after an update! How do I fix this?

      Should your Windows app shortcut stop working after installing an app update, you can normally fix this in one of two ways: a.) Uninstall your current version, then download and reinstall the latest version. You can find the latest app version’s ...