obox plugin

See Obox Settings for additional configuration information.

Settings

fs_auth_cache_dict
  • Default: <empty>

  • Values: String

Dictionary URI where fs-auth process keeps authentication cache. This allows sharing the cache between multiple servers.

fs_auth_request_max_retries

If fs-auth fails to perform authentication lookup, retry the HTTP request this many times.

fs_auth_request_timeout

Absolute HTTP request timeout for authentication lookups.

metacache_close_delay
  • Default: 2secs

  • Values: Time

If user was accessed this recently, assume the user’s indexes are up-to-date. If not, list index bundles in object storage (or Cassandra) to see if they have changed. This typically matters only when user is being moved to another backend and soon back again, or if the user is simultaneously being accessed by multiple backends.

Note

Must be less than director_user_expire.

metacache_max_grace
  • Default: 1G

  • Values: Size

How much disk space on top of metacache_max_space can be used before Dovecot stops allowing more users to login.

metacache_max_space
  • Default: 0

  • Values: Size

How much disk space metacache can use before old data is cleaned up.

Generally, this should be set at ~90% of the available disk space.

metacache_rescan_interval
  • Default: 1 day

  • Values: Time

How often to run a background metacache rescan, which makes sure that the disk space usage tracked by metacache process matches what really exists on filesystem.

The desync may happen, for example, because the metacache process (or the whole backend) crashes.

The rescanning helps with two issues:

  • If metacache filesystem uses more disk space than metacache process thinks, it may run out of disk space.

  • If metacache filesystem uses less disk space than metacache process thinks, metacache runs non-optimally since it’s not filling it out as much as it could.

Setting this to 0 disables the rescan.

It’s also possible to do this manually by running the doveadm metacache rescan command.

metacache_roots

List of metacache root directories, separated with :.

Usually this is automatically parsed directly from mail_home and mail_chroot settings.

Accessing a metacache directory outside these roots will result in a warning: “Index directory is outside metacache_roots”.

It’s possible to disable this check entirely by setting the value to :.

Note

This setting is required for metacache_rescan_interval.

metacache_upload_interval
  • Default: 5min

  • Values: Time

How often to upload important index changes to object storage?

This mainly means that if a backend crashes during this time, message flag changes within this time may be lost. A longer time can however reduce the number of index bundle uploads.

obox_fs
  • Default: <empty>

  • Values: String

This setting handles the basic Object Storage configuration.

obox_index_fs

This setting handles the object storage configuration for index bundles.

Changed in version v2.3.18: Fixed to work properly with fs-posix driver. Earlier versions don’t work correctly in all situations.

obox_max_parallel_copies

Maximum number of email HTTP copy/link operations to do in parallel.

If the storage driver supports bulk-copy/link operation, this controls how many individual copy operations can be packed into a single bulk-copy/link HTTP request.

obox_max_parallel_deletes

Maximum number of email HTTP delete operations to do in parallel.

If the storage driver supports bulk-delete operation, this controls how many individual delete operations can be packed into a single bulk-delete HTTP request.

obox_max_parallel_writes

Maximum number of email write HTTP operations to do in parallel.

obox_refresh_index_once_after

This forces the next mailbox open after the specified UNIX timestamp to refresh locally cached indexes to see if other backends have modified the user’s indexes simultaneously.

obox_rescan_mails_once_after

This forces the next mailbox open after the specified UNIX timestamp to rescan the mails to make sure there aren’t any unindexed mails.

obox_track_copy_flags

Enable only if dictmap/Cassandra & Lazy Expunge plugin are used: Try to avoid Cassandra SELECTs when expunging mails.