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

# Install the HTTP Listener Service for iManage

> Install the Draftable Legal HTTP Listener Service so iManage can open files in Draftable even when it is not running, then disable the local iManage listener.

The HTTP Listener Service is a required component of every Draftable Legal machine-wide MSI deployment. This guide covers its full installation and iManage configuration, including the additional steps needed for Citrix/RDS environments and for resolving cases where the local iManage HTTP Listener does not work when Draftable Legal is not running or open in the background.

## What is the Listener service?

The Listener Service allows users to open and load files from iManage (via the Draftable Universal iManage App) even when the Draftable Desktop application is not running.

### How does it work?

The Listener Service does this by hosting a standalone HTTP Server that is also a part of the Draftable Desktop application. This operates (by default) on the same port - 4764. Its utility is in it being a standalone service that is running all the time. By always running, it can wait for a request from iManage to load files into Draftable which then triggers the Service to call the Draftable Desktop application. 

### Does it require internet access?

The iManage HTTP Listener service requires network access to your iManage instance for the purpose of loading the iManage JavaScript API. No authentication credentials are required. For cloud-hosted iManage instances, Internet access is implicitly required. For on-premise installations, the service must be able to reach the URL of your iManage server as configured for the service.

## How to install the Listener Service

### Step 1: Install Draftable Legal System-Wide MSI

First we must ensure we install the new listener service via the System-Wide MSI installer.

**Download and Run Installer:**

* Download the latest system-wide MSI installer from [this link.](https://help.draftable.com/hc/en-us/articles/16018288168601-Enterprise-deployment-options.md)
* Run the installer with administrator rights.

  ![](https://mintcdn.com/draftable/sRBR9umLx5Fvuj-Y/images/using-draftable-legal-with-iManage/image-125.png?fit=max\&auto=format\&n=sRBR9umLx5Fvuj-Y\&q=85\&s=ffe5a79d6170c3a285951be91e91a265)

**Advanced setup steps:**

* During the setup process, choose the **Advanced** Installation option.

  ![](https://mintcdn.com/draftable/sRBR9umLx5Fvuj-Y/images/using-draftable-legal-with-iManage/image-126.png?fit=max\&auto=format\&n=sRBR9umLx5Fvuj-Y\&q=85\&s=b65dee4c4835ee22268745439e2ae5ed)
* Continue the installation as normal, but once you get to the **Product Features** section, under **Integrations,** select the Http service option and ensure you select that the **Entire feature will be installed on the local hard drive.**

  ![](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)
* Continue the installation process until Draftable Legal is completely installed.

### Step 2: Ensure that the new Listener Process is running

We want to ensure that the installation steps above went successfully, hence we can validate the new listener service by checking the task manager after Draftable has finished installing and is currently running.

**Open Task Manager:**

* Press Ctrl + Shift + Esc to open Task Manager.

  ![](https://mintcdn.com/draftable/sRBR9umLx5Fvuj-Y/images/using-draftable-legal-with-iManage/image-128.png?fit=max\&auto=format\&n=sRBR9umLx5Fvuj-Y\&q=85\&s=086db4f15ac1c032a6c6e1258211574e)
* Navigate to the "Services" tab.

**Locate iManage Listener Process:**

* Look for Draftable.HttpListener in the list of services.

  ![](https://mintcdn.com/draftable/sRBR9umLx5Fvuj-Y/images/using-draftable-legal-with-iManage/image-129.png?fit=max\&auto=format\&n=sRBR9umLx5Fvuj-Y\&q=85\&s=f76b97e8bfd28555d6be55286b20a5b4)
* As long as you can see this service, you have correctly installed the new listener service

### Step 3: Disable the local iManage HTTP listener

To prevent port conflicts, disable Draftable's local iManage HTTP listener using the **Enable local HTTP Listener** policy or the registry fallback below.

> [!WARNING]
>
> The **Enable local HTTP Listener** policy works with the **26.10.1 templates (revision 2610.1)** on **Draftable 26.10.1 or later**. With older templates, the policy has no effect. Import the [26.10.1 templates](https://help.draftable.com/hc/en-us/articles/28666057117721-Draftable-Legal-Group-Policy-Template-Files.md), then configure the policy again. Set it to **Disabled** to turn off the local listener. Alternatively, set the registry value below directly, for example through Group Policy Preferences. Restart Draftable after applying the setting.

**Registry fallback: disable the local iManage HTTP listener**

For system-wide deployment, set the following registry value:

```bash theme={null}
Key: HKLM:\Software\Policies\Draftable\HttpListener
Value name: CommunicationEnabled
Value type: REG_DWORD
Value data: 0
```

To apply the setting per user, use `HKCU:\Software\Policies\Draftable\HttpListener` with the same value name, type and data.

Restart Draftable.

## Troubleshooting 

If you have issues with installing the HTTP listener service, you may see the following error:

![](https://mintcdn.com/draftable/sRBR9umLx5Fvuj-Y/images/using-draftable-legal-with-iManage/image-131.png?fit=max\&auto=format\&n=sRBR9umLx5Fvuj-Y\&q=85\&s=9361ef39aef8a0b95600320226036f05)

This issue occurs when the local iManage listener is not disabled. Hence, please ensure that it is not enabled, restart Draftable and attempt the configuration again.

If you encounter issues during the setup, consult the Draftable support team for further assistance at [support@draftable.com](mailto:support@draftable.com)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.