ports/mail/dovecot-fts-xapian/pkg
2023-08-16 22:26:55 +00:00
..
DESCR SecBSD's official ports repository 2023-08-16 22:26:55 +00:00
PLIST SecBSD's official ports repository 2023-08-16 22:26:55 +00:00
README SecBSD's official ports repository 2023-08-16 22:26:55 +00:00

+-----------------------------------------------------------------------
| Running ${PKGSTEM} on OpenBSD
+-----------------------------------------------------------------------

To use fts_xapian with Dovecot, ensure fts and fts_xapian plugins are
loaded. Adding them to mail_plugins in 10-mail.conf should suffice for
most users:

    mail_plugins = (...) fts fts_xapian (...)

The service's vsz_limit may need to be increased (or disabled) in 10-master.conf:

    service indexer-worker {
      vsz_limit = 0 # or 1GB etc.
    }

Then configure the plugin's settings in 90-plugin.conf:

    plugin {
      fts = xapian
      fts_xapian = partial=2 full=20 attachments=0 verbose=0

      fts_autoindex = yes
      fts_enforced = yes

      fts_autoindex_exclude = \Trash
    }

Parameters 'partial' and 'full' are required, and allow control over the length
of n-grams generated for searching header fields.

Parameter 'attachments' defaults to off. Setting it to 1 will enable indexing of
text attachments.

Parameter 'verbose' can be set between 0 (default) and 2 (debug) for more
detailed logging.

New mail will be indexed incrementally. Use doveadm-index(1) to index
existing mail, e.g.:

    doveadm index -A -q '*'