Downloading

Download the latest tarred version of the script (currently 2.8.9) from the official Mojo Mail Download Site. Extract the files locally on your computer using any of the many unzip/untar programs available.

Configuring

There are two separate ways to configure Mojo Mail. Both ways have been outlined below:

Option 1: This option involves changing a few lines in the configuration file that comes with the tarred download (config.pm). These Lines are as follows:

Line 114: $MOJO_ROOT_PASSWORD = 'root_password';

Replace root_password with the desired password you wish to use for Mojo Mail

Line 139: $FILES = '/home/youraccount/mojo_files/';

Replace /home/youraccount/mojo_files with /home/httpd/vhosts/yoursite.com/httpdocs/mojodir, making sure to place your domain in for yoursite.com and your mojo directory for mojodir

Line 156: $MAILPROG = '/usr/lib/sendmail';

Replace /usr/lib/sendmail with /usr/sbin/sendmail

Line 169: $MOJO_URL = 'http://www.changetoyoursite.com/cgi-bin/mojo/mojo.cgi';

Replace changetoyoursite.com with the domain for your site

Option 2: This option involves creating a file called mojo_config.txt and inserting the following:

$MOJO_ROOT_PASSWORD = 'root_password';
$FILES = '/home/httpd/vhosts/yoursite.com/httpdocs/mojodir';
$MAILPROG = '/usr/sbin/sendmail';
$MOJO_URL = 'http://www.changetoyoursite.com/cgi-bin/mojo/mojo.cgi';

Replace root_password with the desired password you wish to use for Mojo Mail, make sure to place your domain in for yoursite.com and your mojo directory for mojodir and replace changetoyoursite.com with the domain for your site

NOTE: You will need to make a single change to the config.pm file:

Line 255: $MOJO_CONFIG_FILE_DIR;

Change this line to reflect the location of your mojo_config.txt file:

$MOJO_CONFIG_FILE_DIR = '/home/httpd/vhosts/yoursite.com/cgi-bin/mojo';

Note: The default setup for Mojo Mail is to utilize a flat file system. However, it can be configured to utilize a database instead.

Uploading

Once you've made the modifications utilizing one of the above options, upload mojo.cgi (and mojo_config.txt if using option 2) to your cgi-bin in ASCII (Text) Mode. The permission for mojo.cgi will need to be changed to 0755 after being placed on the server.

Upload the entire MOJO folder to your cgi-bin. No permission modifications are necessary.

Create the folder under your cgi-bin that you listed for the variable $FILES either in config.pm (Option 1) or mojo_config.txt (Option 2). If you utilized option 2, you can rename mojo_config.txt on the server to .mojo_config to make the file hidden.

Setting Up

Enter http://www.yoursite.com/cgi-bin/mojo/mojo.cgi in your address bar and enter the password you entered during the configuration stage above. You will than be able to start creating lists.

Security

Once you've created all the lists you wish to create, you can add a # sign in front of  the following line, to prevent others from creating new lists:

Option 1 - Line 114: #$MOJO_PASSWORD = 'root password';

Option 2 - Line 1: #$MOJO_PASSWORD = 'root password';