Skip to main content

How to Install the Windows Desktop App as a Local IT Administrator

Sophie
Updated

Purpose

The Medicus desktop app is required to enable the Panic Button functionality and to enable the integration with your GP Order Comms systems such as tQuest and ICE. This user guide will show you how to install the Windows desktop app as a local IT administrator.

Installing the Windows desktop app

The Medicus desktop app is compatible with Windows versions 10 and 11.

Before installing the Medicus desktop app on a machine for the first time, install the .NET Desktop Runtime 8.0.6 or higher. Download the installer from the following location:

Download .NET 8.0 (Linux, macOS, and Windows)

The .NET Desktop Runtime installer requires administrator rights to execute.

Install the Medicus desktop app using the provided MSIX installer package:

  1. Download the ZIP file: https://england.medicus.health/downloads/Medicus_Desktop_App.zip
  2. Extract Medicus_Desktop_App.zip to a folder on your computer.
  3. Open the .msix installer file included in the extracted folder to install.

This package installs the desktop app for the currently logged in user only. It is code signed by Medicus Health and administrator rights are not required for installation.

Once installed the desktop app starts automatically every time the user logs in. It runs in the system tray, displaying the Medicus logo. It has no other immediately accessible user interface, as all functionality is initiated via the Medicus web app. No further configuration is required once installed, as this is carried out automatically when users log in to the Medicus web app.

desktop1.png
The Medicus Desktop App running in the Windows 11 system tray

If you need to support machines that are shared between users, you must ensure that all users will have access to the app. Safety-critical features in Medicus such as the panic button assume that all logged-in users have the Medicus desktop app running at all times.

In these situations we recommend that the desktop app is deployed to your machines as a line-of-business app using an endpoint management solution that supports MSIX packages, such as Microsoft Intune. This will allow you to centrally install and update the desktop app for all your users and machines.

If you are unable to use an endpoint management solution then it is possible to manually install or update the desktop app on a machine using the following steps:

  1. Log in to the machine using an account with administrator privileges.
  2. Copy the MSIX installer package file to the machine.
  3. Open Windows PowerShell in “Run as Administrator” mode.
  4. Enter the following command replacing C:\Users\Example\Downloads with the path of the folder that contains the installer package file:
Add-AppProvisionedPackage -Online -PackagePath "C:\Users\Example\Downloads\medicus.msix" -SkipLicense

Uninstalling the Windows Desktop App

If you cannot use an endpoint management solution to uninstall the Medicus desktop app, you can manually uninstall the app on a machine using the uninstallation script included in the ZIP file.

  1. Download the ZIP File: https://england.medicus.health/downloads/Medicus_Desktop_App.zip
  2. Extract the ZIP File: Extract Medicus_Desktop_App.zip to a folder on your computer.
  3. Log in to the machine using an account with administrator privileges.
  4. Open Windows PowerShell in “Run as Administrator” mode.
  5. Set PowerShell Execution Policy Temporarily (if needed):
    1. To run the uninstallation script, you may need to allow script execution temporarily. Run:
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force

6. Navigate to the folder where you extracted the ZIP file.
7. Run the following command to execute the uninstallation script:

.\Uninstall_Medicus_Desktop_App.ps1

Note: In some environments, the Medicus entry in the Programs menu may persist after running the uninstall script. If this occurs, reboot the machine to complete the uninstall process.