Requirements

Satchmo is based on the Django framework, therefore you do need a fully functioning Django instance to use Satchmo. The Django installation guide will step you through the process.

It is recommended that you use Django 1.1.

Satchmo requires Python 2.4 or later and a database supported by Django.

There is always a challenge in deciding how many dependencies to include in a project. With Satchmo, we strongly believe in avoiding “Not Invented Here” syndrome and using the power of the rich set of python tools available on the web to make Satchmo as flexible and powerful as possible.

There are a number of other Python packages that are required for usage of all the features in Satchmo.

• Satchmo’s thumbnail capability is very robust and utilizes the following packages:

  • Python Imaging Library
  • Sorl Thumbnails

• In order to securely store sensitive information, you will need:

  • Python cryptography toolkit (Windows binary)

• Satchmo creates PDF output for shipping and invoicing using:

  • ReportLab
  • Tiny RML2PDF (download link)

• In order to manage hierarchical data and use XML in shipping and payment modules, we use:

  • Elementtree (included in Python 2.5+)

There are also a number of other Django packages (mentioned below) that you will need to install.

To support multi store configurations:

• Django Threaded Multihost

For flexibility in defining template plugin points:

• Django App Plugins

For the account registration process, you will need:

• Django Registration

Warning

You must use Django registration 0.7 with Satchmo. When 0.8 comes out, we will migrate to the new version.

A valid Django cache backend (file, memcached or DB) is required for the config settings.

The following package is required to load the initial data and run the unit tests:

• PyYaml

Docutils is used for auto generating the admin documentation but is not required:

• Docutils

Sphinx is useful for auto generating the user documentation but is not required:

• Sphinx

If you are using a version of python less than 2.6, you will have to install the backport of the new SSL module to support accessing SSL 2.0 sites often used by payment processors:

• SSL Backport

For reusable, consistent signals:

• Signals Ahoy

Detailed steps for installing these dependencies is included in the installation section.