Fetching contributors…
Cannot retrieve contributors at this time
34 lines (26 sloc) 1.37 KB


0.6: Upgrading from South to Django Migrations

Based on, the procedure should be:

  1. Remove 'south' from INSTALLED_APPS.
  2. Run python migrate --fake-initial.

If you are upgrading from below 0.5, you need to upgrade to 0.5 first to perform required South migrations before moving to 0.6.

0.5: Message templates in files

As of 0.5 message templates are living in the filesystem like normal files instead of resorting in the EmailTemplate in the database. In most cases, South should take care of writing your existing templates to disk and deleting the database models.

0.4: South migrations

Since 5f79f40, the app makes use of South for schema migrations. As of this version, using South with django-newsletter is the official recommendation and installing it is easy.

When upgrading from a pre-South version of newsletter to a current release (in a project for which South has been enabled), you might have to fake the initial migration as the DB tables already exist. This can be done by running the following command:

./ migrate newsletter 0001 --fake