Roundcube fetchmail plugin is a Roundcube plugin, which allows users to download their mail from external mailboxes.
- Roundcube
- Database (PostgreSQL or MySQL)
- fetchmail itself
- Postfix Admin provides convenient
fetchmail.pl
script
- First you need to install fetchmail itself. For Debian you can do so by
sudo apt-get install fetchmail
- Next you should extract Roundcube fetchmail plugin archive into your Roundcube
plugins
folder creating "fetchmail" folder there.
- You can do so either by using
composer
for which there iscomposer.json
, still you need to follow further installation steps since those could not be accomplished withcomposer
- Alternatively you can download needed release from Releases page unpacking it accordingly
-
After that you need to enable newly installed plugin by adding it to Roundcube plugin list. For Debian related config file is
/etc/roundcube/main.inc.php
and relevant setting is$rcmail_config ['plugins'] = array();
Appending , 'fetchmail'
to the list of plugins will suffice.
-
Unless default settings are suitable for you, you need to configure the plugin. See the settings section for more information.
-
You need to create additional table in your database using one of the supplied
.sql
files. Another possibility is to use Postfix Admin table if you have it installed. If using PostgreSQL you may use schemas to sharefetchmail
table between Roundcube and Postfix Admin. Namely creating it inpublic
schema, whereas every other table in it's appropriate schema, likeroundcube
andpostfixadmin
. Please refer to the documentation for more information. -
You will need
fetchmail.pl
script from Postfix Admin distribution. If you don't have Postfix Admin installed, you can obtain requiredfetchmail.pl
script from their repo trunk / ADDITIONS / fetchmail.pl. But be sure to get at least revision [r1766], at which proper handling ofactive
field introduced. Place it to where apropriate. For example, where your mailboxes are, e.g./var/mail
. -
Next adapt
fetchmail.pl
to your config. Most likely you want to change these settings:# database backend - uncomment one of these our $db_type = 'Pg'; #my $db_type = 'mysql'; # host name our $db_host="127.0.0.1"; # database name our $db_name="postfix"; # database username our $db_username="mail"; # database password our $db_password="CHANGE_ME!";
-
Next step is to configure cron for regular mail checking with
sudo crontab -u mail -e
. For example for 5 minute intervals add this:*/5 * * * * /var/mail/fetchmail.pl >/dev/null
. Worth noting that even if you configure cron for a 5 minutes interval, fetchmail will still abide user configured checking interval. As a result setting bigger intervals here manifests them as intervals available to fetchmail, that is setting0 * * * *
here overrides any user setting wich is less then hour -
You might also need to install
liblockfile-simple-perl
and (libsys-syslog-perl
orlibunix-syslog-perl
) on Debian-based systems. -
Lastly there might be need to do
sudo mkdir /var/run/fetchmail; sudo chown mail:mail /var/run/fetchmail
In case you need to edit default-set settings, you may copy config.inc.php.dist
to config.inc.php
and edit setings as desired in the latter file, which will override defaults.
$rcmail_config ['fetchmail_limit']
limits the number of external mailboxes per user allowed. Default is10
.$rcmail_config ['fetchmail_folder']
whether to allow users to specify IMAP folder they wish to download mail from. Default isfalse
.$rcmail_config ['fetchmail_mda']
allows you to specify mda field for fetchmail. This could be useful in case you want to deliver downloaded mail via MDA or LDA directly, rather than forwarding via SMTP or LMTP. For more information please refer to fetchmail manual and fetchmail.pl script. Default is''
, i.e. not used.
This software distributed under the terms of the GNU General Public License as published by the Free Software Foundation
Further details on the GPL license can be found at http://www.gnu.org/licenses/gpl.html
By contributing to Roundcube fetchmail plugin, authors release their contributed work under this license
Arthur Mayer, https://github.com/flames
For a complete list of contributors, refer to Github project contributors page