*** Note: IMAP SSL is required for Gmail accounts and may not work from your localhost environment ***

Choosing a Server
-----------------
Image: Ubuntu 12.04
RAM: at least 512 MB
- save your password -

When the image is built, you can ssh in at the provided IP address:
ssh root@xxx.xxx.xxx.xxx

Set your DNS to Your Server IP Address:
filter.yourdomain.com A record to xxx.xxx.xxx.xxx (IP address)

Run the following steps to install LAMP:
---------------------------------------------------
> sudo apt-get update
> apt-get dist-upgrade
> sudo apt-get install sudo apt-get install apache2 php5 libapache2-mod-php5 php5-curl php5-gd php5-memcache php5-imap php5-mcrypt
> sudo a2enmod rewrite
> php5enmod mcrypt
> nano /etc/php5/apache2/php.ini 
Search for Dynamic Extensions, add:
> extension=imap.so

Install MySQL Server:
---------------------------------------------------
sudo apt-get install mysql-server php5-mysql
- provide a password for mysql: xxxxxxxxxx

Install the Filter source code... 
---------------------------------------------------
> tar -xzvf filter.tar.gz

Configure your site in apache:
---------------------------------------------------
> cd /etc/apache2/sites-available/
> sudo nano /etc/apache2/sites-available/filter.conf

Modify and paste the following site definition:

<VirtualHost *:80>
   ServerName filter.yourdomain.com
   ServerAlias localhost
   DocumentRoot /var/www/filter/app 
   DirectoryIndex index.php
   <Directory /var/www/filter/app/>
      AllowOverride All
      Order Deny,Allow
      Allow from all
   </Directory>
</VirtualHost>

Enable the site
> sudo a2ensite filter.conf

Fix File Permissions for Assets
---------------------------------------------------
sudo usermod -a -G www-data root
chown -R www-data:www-data /var/www/filter
sudo find /var/www/filter/ -type d -exec chmod 755 {} \;
sudo find /var/www/filter/ -type f -exec chmod 644 {} \;
chmod -vR 0777 /var/www/filter/app/assets/
chmod -vR 0777 /var/www/filter/app/protected/runtime
chmod -vR 0777 /var/www/filter/app/protected/uploads
chmod 755 /var/www/filter/app/protected/yiic
chmod 755 /var/www/filter/app/protected/yiic.bat
chmod 755 /var/www/filter/app/protected/yiic.php

Restart Apache:
---------------------------------------------------
sudo service apache2 restart

Initialize the database:
---------------------------------
> mysql -uroot -p
> create database filter;

(replace newuser and password below with your own)
> create user 'newuser'@'localhost' identified by 'password';
> grant all privileges on * . * to 'newuser'@'localhost';
> flush privileges;

Build the configuration file for your application:
---------------------------------------------------
> mkdir /var/secure
> sudo nano /var/secure/filter.ini
- copy & paste in your settings using /docs/sample-config.ini (in this directory) as an example
- use your mysql password and chosen domain

Run the database migrations:
> /var/www/filter/app/protected/yiic migrate up
Enter your admin user name, email and password
- this is what you'll use to log in to the application

Configure CRON to run the checks in the background
---------------------------------------------------
sudo crontab -e
(select 1 for nano)
*/1 * * * * wget -O /dev/null http://localhost/daemon/inbox
*/5 * * * * wget -O /dev/null http://localhost/daemon/index
15 23 * * * wget -O /dev/null http://localhost/daemon/daily
35 * * * * wget -O /dev/null http://localhost/daemon/hourly
15 0 * * 0 wget -O /dev/null http://localhost/daemon/weekly

Check that it's saved:
sudo crontab -l 

Visit your web page:
http://filter.yourdomain.com


Login with your user name and password

You're done!

Visit the website if you need more assistance:
http://simplifyemail.com

And, follow @reifman on Twitter
https://twitter.com/intent/user?screen_name=reifman