Version 11 (modified by andrew, 7 years ago) (diff)


The latest version of South is 0.3. Read the release announcement.

You can check South out of subversion using:

svn co south

Alternatively, you can use the current stable release, 0.3 (while 0.3's API is guaranteed to remain stable, you will get more features from trunk as we update it, and it is unlikely we will break backwards compatability):

svn co south

Or download a gzipped tar of 0.3.

Make sure the south directory is in your python path - just like you did with Django when you installed it - and then add 'south' to your INSTALLED_APPS setting. Run ./ syncdb (taking notice of the new migration-enabled syncdb) and you're ready to go! Have a look our tutorial, or the more in-depth documentation. You might also want to subscribe to my South feed to get updates on new features.

Remember, South is currently only in beta, but it's being used on various projects by us. If you have any problems, see our support page.

Note that South requires a reasonably new version of Django; we're running it against 1.0 alpha, but it should work on 0.97-pre-svn too.

South is released under the Apache Public License, version two.