# Installing the Engine

MsgFiler Engine is an Apple Mail Plug-In that works with [MsgFiler 3](https://msgfiler.com/). To install MsgFiler Engine, follow these instructions:

1. Quit the **Mail** application.
2. Go to the **Finder**
3. Hold the **Option** key and click on the Go menu
4. Choose **Library**
5. Navigate to the **Mail** directory in the **Library** directory
6. Drag **MsgFilerEngine.mailbundle** to Bundles folder in the Mail directory. Create the **Bundles** folder if it does not already exist.
7. If you have never used or installed a Mail plug-in like MsgFiler Engine, you will need to run the following commands in the **Terminal** application:

If you are using **macOS 10.14 or higher**, paste and press enter:

```
sudo defaults write "/Library/Preferences/com.apple.mail" EnableBundles 1
defaults write com.apple.mail EnableBundles -bool true
defaults write com.apple.mail BundleCompatibilityVersion 4
```

{% hint style="warning" %}
You will have to enter your Adminstrator password after the first comment.
{% endhint %}

If you are using **OS X 10.7 or higher**, paste and press enter:

```
defaults write com.apple.mail EnableBundles -bool true
defaults write com.apple.mail BundleCompatibilityVersion 4
```

If you are using **OS X 10.6/Snow Leopard**, paste and press enter:

```
defaults write com.apple.mail EnableBundles -bool true
defaults write com.apple.mail BundleCompatibilityVersion 3
```

8. Launch **Mail**.
9. If you are using **macOS 10.14 Mojave or higher**, open Mail Preferences
   1. Click **Manage Plug-Ins.**
   2. Ensure that **MsgFiler Engine** is checked.
   3. Click **Apply and Restart Mail.**\
      \ <img src="/files/CGDozmNhuRz8NucdSLRX" alt="" data-size="original"><br>
10. Launch **MsgFiler**.
11. Open MsgFiler’s Preferences by clicking on the action menu in MsgFiler and choosing **Preferences**.
12. Click the **Filing** tab.
13. Check Use **MsgFiler Engine to file messages**.
14. Close the **MsgFiler Preferences** window.

<figure><img src="/files/zJw4y0v5mvNGRipUxfwg" alt=""><figcaption></figcaption></figure>

MsgFiler is now configured to use the MsgFiler Engine to file your messages.

{% hint style="warning" %}
When using the MsgFiler Engine, the ability to move the selection up or down will be disabled in favor of Mail’s selection behavior after filing. Undo/Redo support is handled by Apple Mail instead of MsgFiler.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.msgfiler.com/support/engine/install.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.