Exporting Emails

08 May 2024 - sj, tags: archiving, insights, news, product

It’s often a requirement to retrieve a huge number of emails from the archive. The export feature allows you to do that in an asynchronous way.

The upcoming release of 1.8.2 improves the export feature to allow retrieve up to 10,000 emails. It also allows auditors to use the feature.

Enable the export feature

Set the following in /etc/piler/config-site.php

$config['ENABLE_EXPORT'] = 1;
$config['MIN_SIZE_TO_ENABLE_EXPORT'] = 100000000000; // 100 GB

The above settings turn on the feature if the free disk space is at least 100 GB. Feel free to customize the threshold.

Export your emails

The first step is to execute a search query. Then click on the “select all” toggle, and click on the “export selected” icon (it looks like a floppy disk).

A background job is triggered that you can monitor when you click on the “Exports” button in the upper middle part of the GUI. The status is “RUNNING” while the export is in progress. You may download the zip file when the status is “OK”.

After downloading the zip file, be sure to remove it by clicking on the trash bin icon to free up disk space.

Exporting more than 10k emails

If you want to export more than 10,000 emails, then fix the MAX_SEARCH_HITS variable in /etc/piler/config-site.php, eg.

$config['MAX_SEARCH_HITS'] = 20000;