Virtual Attachments Plugin

The virtual-attachments plugin is part of OX Dovecot Pro (Pro only).

Virtual attachments

First, you’ll have to load the plugin which also requires the Virtual Plugin to be loaded:

mail_plugins = $mail_plugins virtual virtual_attachments

Namespace configuration

Then, you’ll have to create a Namespaces for the virtual-attachments, for example:

namespace virtual {
  prefix = virtual/
  separator = /
  location = virtual:/etc/dovecot/virtual:INDEX=~/virtual

namespace virtual-attachments {
  prefix = virtual-attachments/
  separator = /
  location = attachments:~/virtual-attachments

  mailbox virtual/All {
    auto = create

For each folder that you want an attachments folder for, you need to create a corresponding folder in the Virtual Attachments namespace. The mailbox names need to match existing real or virtual mailboxes. Those mailboxes will be mirrored below the virtual-attachments namespace. Each of the mirrored mailboxes will contain one mail per attachment found in the referenced mailbox. The virtual-attachments mailboxes can be auto created (see Mailbox settings). For example:

  • Attachments in INBOX are in virtual-attachments/INBOX

  • Attachments in virtual/All are in virtual-attachments/virtual/All

Storage location with obox

New in version 2.3.17.

When using the virtual-attachments plugin with obox, the virtual INDEX location must point to a directory named “virtual-attachments” in the user home directory. This way the virtual-attachments indexes are added to the obox root index bundles and will be preserved when user moves between backends or when metacache is cleaned.

location = attachments:~/virtual-attachments

The virtual-attachments indexes & cache will be stored in the user root bundle.

It is possible to disable storing virtual indexes in the user root bundle using metacache_disable_secondary_indexes.