Skip to main content

Install the Boost My Mail Windows application

Updated
As a reminder, here are the prerequisites for using our Windows application. Once you have confirmed that you can use the Windows application, you can follow the steps below. 
The V4 Windows client is available in two versions, allowing you to deploy it according to the configuration chosen by your IT team.
 

Step 1 - Choose your deployment method

Per user (.exe)

IT fleet deployment (.msi)
  • My workstations are standalone.
  • Each workstation is used by a single employee.
  • My IT fleet is centrally managed by software (for example, SCCM)
  • My employees use thin clients or remote sessions (TSE, Citrix, VmWare).

 

Step 2 - Plan your deployment

Per user (.exe)

IT fleet deployment (.msi)
  • Automatic updates are enabled and installed without requiring administrator privileges.
  • The application files are installed in %LocalAppData%\boostmymail
  • Automatic updates are disabled.
  • The application files are installed in %ProgramFiles%

 

Step 3 - Uninstall existing versions 

Per user (.exe)

IT fleet (.msi)
Uninstall any previous version present on the workstation.
  • If you plan to deploy the MSI version, first run %LocalAppData%\boostmymail\Update.exe --uninstall in the context of the logged-in user to remove the per-user installation.
    This will uninstall the application. User data is preserved and remains present in the %AppData%\BoostMyMail folder.
  • To uninstall the different versions of BoostMyMail (any version earlier than 4.3.1 requires an uninstallation), run the following PowerShell command:
$Programs = Get-WmiObject -Class Win32_product | Where {$_.name -like "boostmymail*"}
Get-Process -Name *boostmymail* | Stop-Process -force
ForEach ($Program in $Programs) {msiexec.exe /x $Program.IdentifyingNumber /qn}
 
PowerShell script (certificate-signed): https://cdn.boostmymail.com/public/scripts/clean_bmm_old_install.ps1 
  • To delete user data, run the following PowerShell command:
Remove-Item -LiteralPath $env:APPDATA\boostmymail -Force -Recurse
 
When the client is started after deletion, the configuration will be generated again.
 
 

 

Step 4 - Deploy the Windows client

 

To install per user

To install the client on an IT fleet 
  • Download the EXE installer from the Boost My Mail portal via Settings > Outlook > Windows application.
  • Download the MSI installer from the Boost My Mail portal via Settings > Outlook > Windows application.

  • Find your security key required for deployment across the fleet.
  • The MSI installer uses msiexec with command-line options.
    msiexec /i BoostMyMail-Setup.msi apikey=XXXX
    The security key is mandatory to install the Windows client. You must add the apikey parameter during installation (if the security key is missing, the installation will be stopped and an error message will be returned).

In the event of an error: 
If the installation fails, you can use the logging parameter to obtain additional information.

msiexec /i BoostMyMail-Setup.msi /l* log.txt apikey=XXXX
If your security key is incorrect, your users will see the message "Invalid security key. Please contact your administrator."

Related to

Related articles

Comments

0 comments

Article is closed for comments.