Upgrade Dada Mail

Upgrading Dada Mail


This doc. will guide you through an upgrade of Dada Mail, originally installed and configured with the included Dada Mail Installer.

For information on how to upgrade Dada Mail from an install that wasn't done using the included Dada Mail Installer, see, Upgrading Dada Mail From Different Installation Types

Step #1 Rename the, "dada" Directory

Dada Mail, "The App" is the collection of files and directories that are in the directory called, dada.

The, dada directory has a structure like this:

 cgi-bin (directory)
    - dada (directory, _lower_ case)
        - mail.cgi 
        - DADA (directory, UPPER case)
            - App (directory)
            - Config.pm
            - etc, etc, etc

This is Dada Mail, The App

Simply rename this directory on your hosting account from:


to something like:


Moving the directory:

Step #2 Install the new Dada Mail

Upgrading will now be similar to installing Dada Mail (https://dadamailproject.com/d/install_dada_mail.pod.html)

Except that on the first screen of the Installer, instead of choosing, "Install"...

Choose, "Upgrade"

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

A new form field will appear labeled, Current .dada_files Location.

If it can automatically be found, the textbox will already be filled with the absolute path to the parent directory of where the .dada_files directory lives. If this path looks correct, click, Continue....

If this isn't the correct location or no location was pre-filled in, fill in the correct location manually. The installer shouldn't allow you to continue, unless this directory is successfully found.

Upgrade Options

Two new options are presented to you in the installer, if you are upgrading.

Create a new .dada_config file

(This is what we suggest in most cases)

Select this option if you are upgrading between major versions of Dada Mail. For example, version 7.0.0 to version 8.0.0 or, from version 8.0.0 to version 8.2.0.

Why Create a new .dada_config file?

Changes are periodically made to Dada Mail's default configuration and it's a good idea to have the installer create a new .dada_config file to take advantage of any new enhancements and also to keep your .dada_config file current and compatible with your new copy of Dada Mail. If you are unsure, use the option to create a new .dada_config file>

The Installer will read your old .dada_config file and pre-fill in the configuration that can be set on this screen. Give it a quick look-over and make sure the information looks correct and make any changes that you would like. This is a good oppourtunity to add/remove installed plugins, or do more advanced configurations, like set up Amazon SES sending.

If you have manually editing the .dada_config file, note that the installer does not support moving over any manual edits when you upgrade. You will need to manually copy over these configurations after the upgrade is completed. The Installer will make a backup of your previous .dada_config file, to make this easy to do.

Use the current .dada_config file

Select this option if you are upgrading between minor versions of Dada Mail. For example, version 8.0.0 to 8.0.1.


It's a very very good idea to look at the changelog and note any incompatibilities between versions. It's possible that incompatibilities could break your installation, when you upgrade.

Changelog: https://dadamailproject.com/d/changes_8_x.pod.html

Dada Mail Project