> ## Documentation Index > Fetch the complete documentation index at: https://help.draftable.com/llms.txt > Use this file to discover all available pages before exploring further. # Upgrading machine-wide installs of Draftable Clean > Move every computer that uses the machine-wide MSI to a new version of Draftable Clean: deploy the new MSI over the old one, prepare users for the app closing, keep your settings, refresh the Group Policy templates and check the version. This guide is for IT administrators who installed Draftable Clean with the machine-wide MSI. The MSI does not update itself, so you deploy each new version yourself. If your users have the per-user EXE, updates are automatic; see [Updating Draftable Clean](https://help.draftable.com/hc/en-us/Draftable-Clean-articles/Updating-Draftable-Clean.md). > [!WARNING] > > **Upgrading closes Draftable Clean and does not start it again.** Anything a user is cleaning at the time is stopped. Deploy outside working hours where you can, and tell users beforehand. See [What happens to Draftable Clean during the upgrade](#what-happens-to-draftable-clean-during-the-upgrade). ## Before you start * You need administrator rights on each computer, or a deployment tool that runs as SYSTEM, such as Microsoft Intune or Microsoft Configuration Manager. * Test the new version on one computer before you deploy it widely. * Check the [release log](https://help.draftable.com/hc/en-us/Draftable-Clean-articles/Release-logs-and-notes/Release-Log-Draftable-Clean.md) for what has changed, including any Group Policy template changes. * The Outlook add-in is updated separately. See [The Outlook add-in is updated separately](#the-outlook-add-in-is-updated-separately). ## Upgrade the MSI You do not need to uninstall the old version first. The new MSI finds the installed version and replaces it in one step. If the upgrade fails part way, Windows Installer rolls back and the previous version stays installed. **1. Download the new MSI** Download [DraftableCleanSystem.msi](https://dl.draftable.com/clean/DraftableCleanSystem.msi), the same link as in [Enterprise Deployment](https://help.draftable.com/hc/en-us/Draftable-Clean-articles/Deployment-options.md). **2. Use the same options as the original install** If you installed to a custom folder with `INSTALLDIR`, or chose features with `ADDLOCAL`, use the same values again. `ADDLOCAL` replaces the default features, so keep `HttpListener` in the list whenever you use it. **3. Deploy the new MSI** Deploy it with the tool you used for the original install, to the same computers. For an unattended upgrade from the command line: ```bash theme={null} msiexec /i DraftableCleanSystem.msi /qn /norestart ``` The full command-line options are in [Enterprise Deployment](https://help.draftable.com/hc/en-us/Draftable-Clean-articles/Deployment-options.md#custom-msi-deployment-via-scripted-automated-installs). **4. Check the version** On an upgraded computer, open Draftable Clean and check **App Version** in the status bar at the bottom right of the window. See [Checking the current version](https://help.draftable.com/hc/en-us/Draftable-Clean-articles/Updating-Draftable-Clean.md#checking-the-current-version). You can also see the version in Windows **Settings** > **Apps** > **Installed apps**. > [!NOTE] > > An MSI cannot install an older version over a newer one. If you try, the installer stops with "A newer version is already installed. Please uninstall it first to proceed." ## What happens to Draftable Clean during the upgrade * **Draftable Clean is closed before its files are replaced.** When the upgrade runs with administrator rights or as SYSTEM, as Intune and Configuration Manager do, it closes Draftable Clean for every user signed in to the computer, including users in Remote Desktop or Citrix sessions. When a user runs the installer themselves and approves the administrator prompt, only that user's copy is closed. * **Work in progress is lost.** Files that were being cleaned are not finished, and cleaned files that the user has not yet saved from Draftable Clean are lost when it closes. Users clean them again after the upgrade. * **Microsoft Outlook and Office are not closed.** * **The Draftable Clean HTTP Listener service** is stopped during the upgrade and started again when it finishes. * **Draftable Clean is not started again.** Users open it from the Start menu or the desktop shortcut. If your users have the Outlook add-in, it tries to start Draftable Clean in the background when the user opens the Draftable Clean pane or adds an attachment to an email. Closing the app is done on a best-effort basis. If PowerShell is blocked on the computer, or the installation folder path contains an apostrophe, a running copy may not be closed. If Draftable Clean will not open after the upgrade, ask the user to quit it from the system tray and open it again, or restart the computer. ## Your settings are kept * **Group Policy and Intune settings** are not part of the installation, so the upgrade does not change them. * **Users' own settings and personal cleaning profiles** are stored for each user in the Windows registry, not in the installation folder, so they are kept. * **License activation** is stored for each user in `%LocalAppData%\DraftableClean`, not in the installation folder, so users do not need to activate again. * **Check access to SharePoint and NetDocuments** after the upgrade and sign in again if prompted. A browser profile change or cleared browser data can require a new sign-in. ## Refresh the Group Policy templates Each version installs its own templates in the `GroupPolicy` folder of the installation folder: ``` C:\Program Files (x86)\Draftable\Draftable Clean\GroupPolicy ``` If the release changed the templates, copy the new `.admx` file and its matching `.adml` file to your Central Store, replacing the old pair. Keep the two files together, because both carry the same revision number. If you imported the templates into Microsoft Intune, update them there too. See [Configuring preferences with Group Policy](https://help.draftable.com/hc/en-us/Draftable-Clean-articles/Configuring-preferences-with-Group-Policy-Draftable-Clean.md#administrative-templates) and [Configuring preferences with Microsoft Intune](https://help.draftable.com/hc/en-us/Draftable-Clean-articles/Configuring-preferences-with-Microsoft-Intune-Draftable-Clean.md). ## The Outlook add-in is updated separately The Outlook add-in is deployed from a manifest in the Microsoft 365 admin center, not by the MSI, so upgrading the MSI does not change it. * **Latest manifest URL**: the add-in updates itself within its major version. * **Pinned manifest URL**: the add-in stays on its version until you deploy a newer pinned manifest. See [Updating the add-in](https://help.draftable.com/hc/en-us/Draftable-Clean-articles/Installing-Draftable-Clean-Outlook-Add-in.md#updating-the-add-in). Keep the desktop application and the add-in on a supported pair. If they are too far apart, the add-in pane shows one of these: * **Draftable Clean Update Required**: the desktop application is older than this add-in needs. Upgrade the MSI. * **Add-in Update Required**: the add-in is older than the desktop application needs. Deploy the current pinned manifest. After you update either one, users click **Recheck Version** in the pane. ## Next steps > [card] [Enterprise Deployment](https://help.draftable.com/hc/en-us/Draftable-Clean-articles/Deployment-options.md) > > MSI features, command-line options and removal. > [card] [Updating Draftable Clean](https://help.draftable.com/hc/en-us/Draftable-Clean-articles/Updating-Draftable-Clean.md) > > How updates work for each installer, and how to check the version. > [card] [Troubleshooting: Outlook Add-in](https://help.draftable.com/hc/en-us/Draftable-Clean-articles/Troubleshooting-Outlook-Add-in.md) > > What to check if the add-in stops working after an update. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.