Installing Rainloop

Modest system requirements, decent performance, simple installation and upgrade, no database required - all these make RainLoop Webmail a perfect choice for your email solution.

If you were expecting to find roundcube the roundcube documentation has been moved to qmail utilities which is here.

Want a better webmail app? I have recently discovered rainloop and it's *FAST* and you can install this in minutes without needing a database. It also works great on mobile devices.


# cd /usr/ports/mail/rainloop
# make install clean

Before we continue rainloop will add some apache modules so we should restart apache:


# /usr/local/etc/rc.d/apache24 restart

Now lets symlink the rainloop folder into the apache directory:


# cd /usr/local/www/apache24/data
# ln -s /usr/local/www/rainloop .

Now lets set the correct permissions before we go to the admin page:


# cd /usr/local/www/rainloop
# find . -type d -exec chmod 755 {} \;
# find . -type f -exec chmod 644 {} \;
# chown -R www:www *

Before we get to the admin page lets tighten up security on the rainloop/data folder. As per the documentation, all configuration, caches, and assorted private data is included within the top-level rainloop directory, but within a data directory. Ideally, no users should be able to access that, so it should be disabled within Apache. Add the following lines in httpd.conf:


# vi /usr/local/etc/apache24/httpd.conf

Add the following lines:


<Directory /var/www/rainloop/data>
Options -Indexes
Deny from all
</Directory>

Now restart apache:


# /usr/local/etc/rc.d/apache24 restart

Now open up your browser and go to https://webmail.domain.com/rainloop/?admin

Default login is "admin", password is "12345".

When you login to the administrative backend it is HIGHLY recommended that you change your password.

Go to the Login tab and type in your default domain name.

Go to the Branding Tab and type in your title and the loading description.

Go to the Contacts tab and enable contacts (optional but recommended)

Under domains click Add Domain. The name can be a wildcard for all or you can specify for each domain. For IMAP server type your IP address and change secure to SSL/TLS. Under SMTP do the same thing and then click test. Both IMAP and SMTP as well as the test button should be highlighted in green text which indicates these tests were sucessful. Click add.

Under the Security section click Require verification of SSL certificate used (HIGHLY recommended)

There are many different packages to install which are all optional. I would suggest reCaptcha and possibly blacklist/whitelist

Rainloop is free for basic functions. You can purchase it per year or a lifetime membership.

Now go to https://webmail.domain.com/rainloop/ and login to your new webmail!