> For the complete documentation index, see [llms.txt](https://docs.msgfiler.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.msgfiler.com/support/engine/install.md).

# 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 %}