Migrating from other software

PostfixAdmin

Modoboa provides a simple script to migrate an existing PostfixAdmin (version 2.3.3+) database to a Modoboa one.

Note

This script is only suitable for a new installation.

First, you must follow the Installation step to create a fresh Modoboa database.

Once done, edit the settings.py file. First, add a new database connection named pfxadmin into the DATABASES variable corresponding to your PostfixAdmin setup:

DATABASES = {
    "default" : {
        # default connection definition
    },
    "pfxadmin" : {
        "ENGINE" : "<engine>",
        "NAME" : "<database name>",
        "USER" : "<database user>",
        "PASSWORD" : "<user password>",
    }
}

This connection should correspond to the one defined in PostfixAdmin’s configuration file.

Then, uncomment the line containing 'modoboa.tools.pfxadmin_migrate' inside the MODOBOA_APPS variable and save your changes.

You are now ready to start the migration so run the following commands:

$ cd <modoboa_site>
$ python manage.py migrate_from_postfixadmin -s <password scheme>

<password scheme> must be replaced by the scheme used within postfixadmin (crypt most of the time).

Depending on how many domains/mailboxes your existing setup contains, the migration can be long. Just wait for the script’s ending.

The procedure is over, edit the settings.py file and:

  • remove the pfxadmin database connection from the DATABASES variable
  • remove the 'modoboa.tools.pfxadmin_migrate', from the MODOBOA_APPS variable

You should be able to connect to Modoboa using the same credentials you were using to connect to PostfixAdmin.

Table Of Contents

Previous topic

Available events

Next topic

Using the virtual machine

This Page