Vexim 2.2 on Python and Django

From Veximwiki

Jump to: navigation, search

Quick instructions for testing the latest version of Vexim, running on the Python Django framework.

  • Install python (at least version 2.3, version 2.5 is preferred)
  • Install django (at least version 0.96, newer is preferred)
  • Check out the Vexim python source code:
export CVSROOT=:pserver:anonymous@pear.silverwraith.com:/home/cvs
cvs login
[Press enter when prompted for a password]
cvs checkout vexim3
  • Create a MySQL database called vexim3django:
mysqladmin -u root -p create vexim3django
  • Create a new MySQL user and grant them full permission on the vexim3django database
  • Edit vexim3/vexim/settings.py You will need to specify the MySQL username and password you created in the previous two steps on the DATABASE_USER and DATABASE_PASSWORD lines.
  • Edit the MEDIA_ROOT line. Set YOUR_WWW_ROOT to top level directory containing vexim
  • Edit the MEDIA_URL. Set YOUR_HTTP_ADDRESS to the URL you will use to access vexim. Eg, http://vexim.example.com.
  • Edit some of the default values in vexim3/vexim/mail/app_settings.py
  • Sync the Django database models to your database. you will be prompted to create a superuser. Choose the username and password carefully, this will be your siteadmin user:
python vexim3/vexim/manage.py syncdb
  • You can test that everything worked, by running:
python vexim3/vexim/manage.py runserver YOUR_IP:8888

Then browse to http://YOUR_IP:8888/admin/ and try to log in with the username and password created during the Django syncdb step. This will take you to the site admin pages.


Things the current installer does not do

  • Please add things here that you think the installer should do!
  • Provide functionality to upgrade from 2.2.1 or
  • Provide data-migration from 2.2.1 (db-contents)

TODO list for this version of Vexim: Vexim_2.2_on_Python_and_Django_TODO#mail.2Fmodels.py

Personal tools