obox-storage plugin

obox-storage-plugin

obox_allow_inconsistency

Even in case of object storage errors, try to allow accessing the emails as well as possible. This especially means that if the local metacache already has a copy of the indexes, they can be used to provide access to user’s emails even if the object storage is unavailable.

obox_fetch_lost_mails_as_empty

Cassandra: “Object exists in dict, but not in storage” errors will be handled by returning empty emails to the IMAP client. The tagged FETCH response will be OK instead of NO.

obox_track_copy_flags

Enable only if Cassandra & lazy_expunge plugin are used: Try to avoid Cassandra SELECTs when expunging mails.

obox_disable_fast_copy

Workaround for object storages with a broken copy operation. Instead perform copying by reading and writing the full object.

obox_size_missing_action

This setting controls what should be done when the mail object is missing the size metadata. Default (warn-read) is to log a warning and fallback to reading the email to calculate its size. read is the same but doesn’t log a warning. stat uses fs_stat() to get the size, which is the fastest but doesn’t work if mails are e.g. compressed or encrypted.

obox_username

Overrides the obox username in storage. Normally the username is taken from the mail_location setting.

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.

metacache_socket_path

Path to communicate with metacache process. Shouldn’t be changed normally.

obox_fs

This setting handles the basic Object Storage configuration, typically via the plugin block of 90-plugin.conf.

obox_index_fs

This setting handles the object storage configuration for index bundles.

Warning

obox_index_fs is currently not compatible with fs-posix driver.

obox_lost_mailbox_prefix

If folder name is lost entirely due to lost index files, generate a name for the folder using this prefix. The default is “recovered-lost-folder-“.

obox_no_pop3_backend_uidls

There are no migrated POP3 UIDLs. Don’t try to look them up in any situation. Normally this shouldn’t be necessary to use.

metacache_bg_root_uploads

By default doing changes to folders (e.g. creating or renaming) uploads changes immediately to object storage. If this setting is enabled, the upload happens sometimes later (within metacache_upload_interval).