Installing and Configuring Dada Mail


Step #1: Download Dada Mail

Here's the direct download to Dada Mail v5.0.1

https://github.com/downloads/justingit/dada-mail/dada-5_0_1.tar.gz

Pro Dada Subscriber?

Download Pro Dada at:

http://dadamailproject.com/pro_dada


Step #2 Upload the, "dada-5_0_1.tar.gz" distro to your cgi-bin

Download the dada-5_0_1.tar.gz distro (you will not have to uncompress the distribution) and then upload it to your hosting account's cgi-bin.

In these directions we suggest the cgi-bin, but feel free to use any directory that you know will work. See also: Installing Dada Mail in a directory other than in your, "cgi-bin"


Step #3 Upload the, "uncompress_dada.cgi" script to your cgi-bin

Download the, uncompress_dada.cgi script from here:

and upload this script (PlainTest/ASCII mode - NOT binary!) to your hosting account's cgi-bin - right alongside the dada-5_0_1.tar.gz distro you just put up.


Step #4 Change permissions of the, "uncompress_dada.cgi" file to, "755"


Step #5 Visit the, "uncompress_dada.cgi" script in your web browser.

The, uncompress_dada.cgi should attempt to uncompress the dada-5_0_1.tar.gz distro, change the necessary permissions of various files and prep the actual installer for you to use.

Once it's finished running, you should be presented a link to use the actual installer. Click the link at the end of the screen and go ahead and configure Dada Mail!

See, Prepping Dada Mail Manually if this doesn't happen and you get a message in your browser window, sort of like this:

Can't find dada-5_0_1.tar to uncompress!You may have to uncompress and prep Dada Mail manually.


Configuring Dada Mail with the, "install.cgi" Script

The installer should be relatively straightforward on how it's used - just fill it out with the information it's asking for. Below, we'll explain exactly what it's looking for.

Choose, "Installation"

The first screen of the installer will ask you if you'd like to Install, or Upgrade Dada Mail. Choose, "Installation" and click, "Continue..."

Onto the next screen!

A Warning Up Top?

It's possible that before you even start using the Dada Mail installer, that you'll receive a warning stating that Dada Mail won't be able to edit the, dada/DADA/Config.pm file. This would be because there's a difference in file permissions/privileges between the user that the installer is running under and the user that owns the dada/DADA/Config.pm file.

This means you'll need to edit one line in the dada/DADA/Config.pm file to get Dada Mail running correctly.

".dada_files " Directory Location

Fill out the location on where to place the, .dada_files directory.

The installer will do its best to pre-fill out the best location for you - and you can just use it's best guess and forgo having to know the exact details.

For most installations, we suggest having the installer create the, .dada_files directory in your home directory. All you'll need to do is fill out where your home directory is located. Find out what the location of your home directory is from your webhost, if you do not already know it.

Dada Mail URL

The Dada Mail URL is simply the URL that you will access Dada Mail's, mail.cgi file from. This form field should be filled out automatically, but if something doesn't look right, just look at the URL of the installer - for example, if the URL of the installer is:

http://example.com/cgi-bin/dada/installer/install.cgi

Your Dada Mail URL will be:

http://example.com/cgi-bin/dada/mail.cgi

Dada Mail Root Password

The, Dada Mail Root Password is the main administrative password to your Dada Mail installation - choose a good, strong password - all you'll need to do is enter it twice, just to make sure you know exactly what it's set to.

Dada Mail Backend

Dada Mail will need to save its mailing lists and other information in various files and/or an SQL database. The SQL database is optional, but we highly suggest using it:

Tons of stuff.

Default

Select Default if you cannot, do not know how, or do not want the SQL backend option (we really suggest going the distance and using the SQL backend)

MySQL, PostgreSQL or SQLite

Both MySQL and PostgreSQL will have the same features available and work under the hood, basically the same way. We personally like PostgreSQL better, but MySQL is going to be tested a bit more thouroughly and probably is more familiar to most people, so at the moment, it's the backend that we recommend.

SQLite is also an option, but we recommend using it for testing purposes, only.

When you select one of the SQL backends, you'll also be asked to fill in the SQL connection information, including the database server, the port number, the name of the database itself and the username and password.

This database has to be set up beforehand. It's not too hard to do if you have a cPanel w/phpMyAdmin to help you along. Just note the Server, Database, Username and Password, once you create the database (No tables have to be created, beforehand). The SQL user will need full priviliges to your database. We don't suggest, for security reasons, giving this same user any permissions to any other database.

Don't worry about filling any of these out if you've chosen to use the SQLite backend. Yeah!

Plugins/Extensions

Optionally, you may also install many of the plugins and extensions that come with Dada Mail. Access to the plugins/extensions will be available in the list control panel's admin menu.

Some of the plugins/extensions have additional configuration that will need to done, before they work completely. For the majority of these plugins/extensions, you'll need to also set a cron job.

One plugin, Bounce Handler, also requires you to fill out the credentials for the bounce handler email account you need to set up to capture bounced emails.

Completing the Installation and Configuration.

Once you've filled out the form completely, just click the, Configure Dada Mail! button. The screen will refresh and go about configuring Dada Mail for your hosting setup.

If everything works well (and we hope it does) you should be all set to run Dada Mail.

Do You Need to Manually Edit The, "dada/DADA/Config.pm" File?

There's a possibility, especially if you were issued the warning before filling out the configuration form, that you'll have to edit a line in the, dada/DADA/Config.pm file. If this is the case, the installer will show you which file to look for and what to change it to.

Be careful when editing this file, as any error will stop Dada Mail from working. When saving the file and putting it back up to your hosting account, make sure to upload the file in ASCII/Plain Text mode, NOT binary!

Moving the, "installer" directory

Dada Mail will not start working, until you move the, dada/installer directory out of the way. This is a security precaution, so someone else doesn't come along and attempt to reconfigure your Dada Mail!

The provided button should do the trick, but if it fails (it'll let you know), you'll have to remove it manually. If you had to do the above step manually, you'll most likely have to do this step manually, too.

Making Additional Edits

The installer should give you the full path to the, .dada_config file it creates. This is the file that is written that holds your configuration that the installer just created. There's a ton of additional configuration options you can set - the installer just gets you up and running correctly.

Making additional configurations is a lot more advanced than running the installer, so be careful when editing this file - make a backup, first.

Running Dada Mail for the First Time

Once you've gotten the, dada/DADA/Config.pm file edited (if needed) and moved the, installer directory out of the way, it's time to begin using Dada Mail. Click the, Start Working With Dada Mail! button to begin!

Good Luck!


Command Line Interface

An alternative, command line interface is available, instructions can be found on how to use it, by invoking the script with the, --help flag,

 shell>./installer.cgi --help

most of the options available on the web-based interface are available in the command line interface, except the installation of the plugins/extensions.


Screencasts

The below screencasts go through the installation process:

How to Download, Install and Configure Dada Mail v5


Manual Installation

We suggest using the Dada Mail Installer, but you can still install Dada Mail manually:

manually_install_dada_mail.pod.html