> ## 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.

# Deployment options via MSI (System wide) installer

> This guide is for IT administrators who wish to deploy Draftable Legal and want to select what additional parameters are included within the install. This can include selections for Office add ins (Outlook and Word), shortcuts and options for the iManage listener sevice. This guide is specific to the Machine-Wide MSI (also known as the System-Wide MSI, Native MSI, or Per-Machine MSI) and only from DraftableDesktopSystem.msi v2.15 onwards. 

<Note>
  **Deploying via Microsoft Intune?** If you're planning to deploy Draftable Legal using Microsoft Intune, you can use both this article and our dedicated [Enterprise installation for Draftable using Intune](/hc/en-us/articles/19521353760921-Enterprise-installment-for-Draftable-using-Intune) article as reference points. The Intune article covers adding Draftable to Intune, deploying via Intune, and managing product keys through Intune group policy.
</Note>

## Deployment options via standard MSI installer

<Warning>
  **Deploying to Citrix or Remote Desktop (RDP/RDS)?** Licensing in these environments needs to be configured for your setup before your users activate. Please read [Deployment advice for Citrix and RDP environments](/hc/en-us/articles/Deployment-advice-for-Citrix-and-RDP-environments) before you deploy.
</Warning>

<Warning>
  **Install the HTTP Listener Service — this is required.** The HTTP Listener Service (the `HttpListener` MSI feature) is a required component of every machine-wide MSI deployment. It provides support for launching comparisons from iManage (including on multi-user systems such as Citrix and RDS), lets Draftable open when it is not already running, and is required for the Draftable Outlook add-in (Redline in Email). It is **not** selected by default in the installer, so you must include it explicitly: in the **Advanced** installer set **Http service** (under **Integrations**) to install, or add `HttpListener` to your `ADDLOCAL` list in a scripted or silent install.
</Warning>

<Steps>
  <Step>
    Download and run the Machine Wide MSI (you can download the latest version of this installer via [https://dl.draftable.com/desktop/DraftableDesktopSystem.msi](https://dl.draftable.com/desktop/DraftableDesktopSystem.msi))
  </Step>

  <Step>
    In the installation menu, select the **Advanced** option and click 'next'\
    Select item to see menu

    <Frame>
      <img src="https://mintcdn.com/draftable/B2kzCCfUvVdHgQCw/images/draftable-legal/image-216.png?fit=max&auto=format&n=B2kzCCfUvVdHgQCw&q=85&s=251184f5a566e4cbaca73b4bc4c37b7a" alt="" width="402" height="319" data-path="images/draftable-legal/image-216.png" />
    </Frame>
  </Step>

  <Step>
    In the Advanced screen, you will see an expandable feature tree user interface. Expand the **Draftable Desktop** node, then the **Office add-ins** node to view individual add ins (pictured)

    <Frame>
      <img src="https://mintcdn.com/draftable/B2kzCCfUvVdHgQCw/images/draftable-legal/image-217.png?fit=max&auto=format&n=B2kzCCfUvVdHgQCw&q=85&s=05d0d945adc5335da075508a1df8270e" alt="" width="535" height="418" data-path="images/draftable-legal/image-217.png" />
    </Frame>
  </Step>

  <Step>
    **Select** the add in(s) that you do not want installed and use the menu to select **Entire feature will be unavailable**

    <Frame>
      <img src="https://mintcdn.com/draftable/B2kzCCfUvVdHgQCw/images/draftable-legal/image-218.png?fit=max&auto=format&n=B2kzCCfUvVdHgQCw&q=85&s=979ef6a37542d0bbbd703414d95d4e80" alt="" width="534" height="414" data-path="images/draftable-legal/image-218.png" />
    </Frame>
  </Step>

  <Step>
    Expand the **Integrations** node and set **Http service** to **Entire feature will be installed on the local hard drive**. The HTTP Listener Service is a required component and is **not** selected by default, so this step must not be skipped.

    <Frame>
      <img src="https://mintcdn.com/draftable/sRBR9umLx5Fvuj-Y/images/using-draftable-legal-with-iManage/image-127.png?fit=max&auto=format&n=sRBR9umLx5Fvuj-Y&q=85&s=509363cd4f36c52b57adec02ef1974e1" alt="" width="532" height="416" data-path="images/using-draftable-legal-with-iManage/image-127.png" />
    </Frame>
  </Step>

  <Step>
    Select **Install** to proceed with installation
  </Step>
</Steps>

<Note>The iManage HTTP Listener Service requires more configuration beyond that is setup in this article. The steps in this article merely deploys the Listener Service, but for complete configuration [please see here.](/hc/en-us/articles/33978111642905-Alternative-iManage-HTTP-listener-service-installation-guide-for-Draftable-Legal)</Note>

## Custom MSI deployment via scripted automated installs

The following steps are suitable for administrators deploying Draftable Desktop via a command line interface, InTune or similar. It outlines how to programmatically control features being installed by the MSI via the well-known [ADDLOCAL property (link to Microsoft Learn page)](https://learn.microsoft.com/en-us/windows/win32/msi/addlocal).  This allows administrators to provide a comma-separated list of features to be installed.

<Warning>
  **Always include the HTTP Listener Service (`HttpListener`).** It is a required component of every machine-wide MSI deployment. Because `ADDLOCAL` installs **only** the features you list, you must include `HttpListener` in every `ADDLOCAL` command — otherwise the service will not be installed. For complete iManage configuration (including Citrix/RDS), please refer to the [iManage HTTP Listener Service installation guide](/hc/en-us/articles/33978111642905-Alternative-iManage-HTTP-listener-service-installation-guide-for-Draftable-Legal).
</Warning>

The features available for specification are listed in the table below

| Feature name ("Title")        | Feature ID ("Feature") |
| :---------------------------- | :--------------------- |
| Draftable for Outlook         | OutlookAddin           |
| Draftable for Word            | WordAddin              |
| Draftable for Excel           | ExcelAddin             |
| Desktop                       | DesktopShortcut        |
| Start Menu                    | StartMenuShortcut      |
| iManage HTTP Listener Service | HttpListener           |

Use the ADDLOCAL property to programmatically specify which 'Features' are installed by the MSI by listing the Feature ID (see table above). *Note, this property specifies what IS INSTALLED. Features absent from this property will NOT be installed.*

### Basic command - MSI installation

Below is a **basic** example of how to install Draftable via a command line. This example shows installation without the Outlook add-in but including the Word and Excel add-ins and the two shortcuts and the iManage HTTP Listener Service.

```bash theme={null}
msiexec /i DraftableDesktopSystem.msi ADDLOCAL=StartMenuShortcut,DesktopShortcut,HttpListener,WordAddin,ExcelAddin
```

Based on the above, running the installer would result in the following Advanced UI set-up:

<Frame>
  <img src="https://mintcdn.com/draftable/B2kzCCfUvVdHgQCw/images/draftable-legal/image-219.png?fit=max&auto=format&n=B2kzCCfUvVdHgQCw&q=85&s=7cdd9590110b6aa735952b44fb3d8fdc" alt="" width="528" height="418" data-path="images/draftable-legal/image-219.png" />
</Frame>

### Advanced command - MSI installation

If you wanted a more complex configuration that specifies: 

* The install location
* Multiple Draftable add-ins
* HTTP listener service for imanage
* Quiet/silent installation
* Specify no machine restart after installation
* Verbose logging of the full install. **Recommended** if you are having issues with certain components not installing correctly.

The command below is more **advanced** with demonstrates more options during installation.

```powershell theme={null}
Start-Process msiexec -ArgumentList '/i "DraftableDesktopSystem.msi" ADDLOCAL=StartMenuShortcut,DesktopShortcut,HttpListener,WordAddin,ExcelAddin,OutlookAddin INSTALLDIR="C:\Program Files (x86)\Draftable" /qn /norestart /L*V "C:\Logs\draftable_install.log"' -Wait
```

For logging to work, please ensure you create the logging location **prior** to installation. This command will also wait to complete before returning to the command line, that way you know when the installation is completed. 

If you need further assistance in deploying the Draftable Machine-wide MSI via command line, please contact [support@draftable.com](mailto:support@draftable.com)

## Troubleshooting Add-in Installation Issues

If Office Add-ins are not loading correctly after MSI installation, this may be due to the LoadBehavior registry value not being set correctly. For troubleshooting steps, see [Office Add-ins Not Loading After MSI Installation](/hc/en-us/articles/53125847291673-Office-Add-ins-Not-Loading-After-MSI-Installation).