We hope you find this tutorial helpful. In addition to guides like this one, we provide simple cloud infrastructure for developers. Learn more →

Installing the RainLoop Email Client on Ajenti V

PostedJuly 1, 2015 35.2k views Email Arch Arch Linux CentOS CoreOS Debian FreeBSD RHEL Ubuntu

Introduction

RainLoop is a free email client that can access any IMAP/SMTP emails, including Ajenti V's built-in email. It supports multiple accounts, social logins (log in with Twitter, Facebook, etc.), two factor authentication, and more. RainLoop is a great program to install with Ajenti V because the Ajenti V platform itself has no default webmail.

Screenshot of Rainloop

At the end of this tutorial we will have RainLoop installed on mail.example.com with IMAP/SMTP access to mailboxes on example.com.

Prerequisites

Step 1 — Creating the RainLoop Website in Ajenti V

In your browser, browse to your Ajenti control panel (usually located at https://panel.example.com/), and log in. In the sidebar to the right, under the Web section, click Websites.

Under the New Website section there is a Name text field. Type RainLoop and click the Create button. Under the Websites section on that same page, click Manage on the new RainLoop line.

On the page that appears, uncheck the box next to Maintenance mode. In the Website Files section below that, change Path from /srv/new-website to /srv/RainLoop. Press the Set button next to that text field. Then press the Create Directory button below that. Click Apply Changes at the bottom of the screen.

On the top of the page, click the Domains tab. Click Add and replace example.com with mail.example.com, replacing example.com with your domain name. Click Apply Changes at the bottom of the screen.

RainLoop is PHP-based, so now we need to enable PHP for the RainLoop website we are creating. Click the Content tab. Change the dropdown box to PHP FastCGI, and click Create.

Now click the Advanced tab. In the Custom Configuration box, enter:

location ^~ /data {
  deny all;
}

This addition denies web access to information stored in the /data directory.

Click Apply Changes at the bottom of the screen. Configuration should now be complete. The next step is to install RainLoop.

Step 2 — Installing RainLoop

In the Ajenti sidebar, under the Tools section, click Terminal. Click the New button at the top of the screen, then click the black box that appears.

Note: All commands here are run as root.

At the terminal prompt, type:

  • cd /srv/RainLoop

Press ENTER. Then, type the following to install some software dependencies:

  • apt-get install php5-cli php5-curl

Press ENTER to start the installation process. Press Y if prompted. Finally, enter the following to install RainLoop:

  • wget -qO- http://repository.rainloop.net/installer.php | php

Press ENTER. This command extracts all RainLoop files and installs them on the server.

Now we should set the correct permissions for the files and make them owned by the correct user. Enter these commands in the same terminal, pressing ENTER after each one:

find . -type d -exec chmod 755 {} \;
find . -type f -exec chmod 644 {} \;
chown -R www-data:www-data .

Now that all the files and directories are setup, you can press the X on the Terminal 0 tab to leave the terminal.

Step 3 — Changing the Admin Password

Browse to http://mail.example.com/?admin in your web browser, replacing example.com with your domain name. The default username is admin, and the default password is 12345. Log in with those credentials.

When you login for the first time, you will be greeted with a warning:

Warning shown in RainLoop after installation

The change word in the warning is a link. Click it, and change the admin password to make your installation more secure. Click Update Password to finish changing it. The button will turn green, signifying your change was accepted.

Step 4 — Setting Up Your Domain

In the sidebar of RainLoop, click Login. In the Default Domain text field, you should enter the domain that comes after the @ in your Ajenti V email (usually this is your registered domain name). Press ENTER, and a green check mark will appear temporarily, showing it's saved.

In the sidebar, now click Domains. There is a list of default email domains already added. This list includes commercial domains such as gmail.com, outlook.com, qq.com, and yahoo.com. If you have an account with one of those services and you would like to be able to check them within RainLoop, you can leave them. Otherwise, you can click the trash can icon next to them to remove them.

Now, click Add Domain at the top of that page. In the Name field, enter your domain name such as example.com. Under the IMAP section, below Server, enter mail.your_domain_name. Under Secure, use the dropdown to select STARTTLS. Now under the SMTP section, below Server enter mail.your_domain_name.

Example configuration

At the bottom of this screen click the Test button. If it turns green, click the Add button at the bottom of the modal to add your domain. If it turns red, read the error messages to figure out why it can't connect.

Step 5 — Enabling Two Factor Authentication (Optional)

If you use a service like Google Authenticator or Authy, this section may be of interest to you.

Browse to the Security option in the sidebar. Check the box next to Allow 2-Step Verification. Optionally, you can check the box next to Enforce 2-Step Verification as well, but this isn't necessary unless you have multiple users using this and you want them all to be forced to use Two Factor Authentication.

Enabling 2FA

You will learn how to configure Two Factor Authentication later in this tutorial.

Step 6 — Logging in to RainLoop

Browse to http://mail.your_domain_name. Enter your entire email address (not just your username) in the first box and your email password in the next. This is not your admin login. Rather, it is the account information you specified when setting up your mailbox in Ajenti. Check the Remember Me box if you do not want to have to log in every time you visit RainLoop on your computer.

Once you login, you should be done! You can now read your email messages and compose. You can choose to finish here or continue with some optional settings.

Step 7 — Customizing RainLoop (Optional)

At the top of the page, click the dropdown button with the silhouette person icon.

Profile Menu

Click Settings. In the first screen that shows up, you will have the option to configure general details to your liking. You can choose between vertical and horizontal layouts, the default text editor, etc.

One option that may be useful is the Notifications options. If this is your primary email client, you might want to enable notifications upon email arrival. Just check both boxes under the Notifications section to start getting popups from your browser when you receive an email:

Email notification popup

As you can see, it shows who sent the email and the subject line. Simply click it to read the full message in your browser. RainLoop will need to be open in a browser tab at all times for this to work.

Step 8 — Setting Up Two Factor Authentication (Optional)

If you would like to set up Two Factor Authentication, follow these steps. Log into the RainLoop user interface at http://mail.your_domain_name and go to Settings. In Settings, click Security in the sidebar. There should be a link titled Configurate 2-Step Authentication. Click it, and click the Activate button that appears.

2FA Setup

Note: The following screenshots are for Google Authenticator. The steps for your authentication app may vary.

In Google Authenticator, under Manually Activate an Account, click Scan a barcode. You may be prompted to install a barcode scanner app. If so, install it and return to the app.

Scan a Barcode

Now scan the QR code displayed on the webpage.

Scan the code

There should now be a six-digit code displayed on your phone. You will need this code to sign into your webmail.

2FA on Phone

Back in the Two Factor Authentication modal on your computer, next to Enable 2-step verification at the top, there will be a link that says test. Click it, enter the 6-digit code on your phone, and press ENTER. If the button turns green, click the X on that window, and check the box next to Enable 2-Step verification. Then press Done at the bottom of the screen.

From now on, every time you sign into RainLoop, you will need to lookup the six-digit code in Google Authenticator and enter it along with your username and password combination.

2FA login

Writing an Email

Back at the homepage of RainLoop, where you can view your emails, there is an icon of a paper airplane in the top left corner of the page. Simply click it and the compose email modal box will appear, allowing you to write an email.

Compose email modal

When you finish, click Send, and your email will be sent to its recipient.

Conclusion

RainLoop should now be installed on your server, granting easy email account access to your mailboxes from any web browser.

21 Comments

Creative Commons License