The recommended way to run solitude is in Docker.

For running solitude in the marketplace environment, we recommend using Docker and reading the marketplace docs.

For running solitude in the Payments for Firefox Accounts, we recommend using Docker and reading the payments docs.


If you don’t have Python or MySQL installed. On OS X, homebrew is recommended:

brew install python mysql

Don’t forget to set the default mysql password for your root user in that case (an empty password is possible):

mysql -uroot -p

Optionally install a virtualenv.


From github:

git clone git://

If you used a virtualenv activate it and compile some playdoh dependencies:

cd solitude
pip install --no-deps -r requirements/dev.txt


Solitude will work without any settings changes at all with zippy, the reference implementation of the payment provider.

However since solitudes main job is to communicate with remote payment providers you will need to configure those. To do so create a settings file.

Create an empty settings:

cd solitude/settings
echo "from . import base" >

Running tests

To run unit tests:

python test

All live server and Braintree integration tests are not run by default. To run live server and Braintree integration tests:

LIVE_TESTS=live,braintree python test

The value of LIVE_TESTS is passed to the nose args command.

For the Braintree tests to pass, you will need to have setup a Braintree sandbox account.

Bango settings

To process payments with Bango, you will need a Bango account. Once you have that, setup your account details:

BANGO_AUTH = {'USER': 'the.bango.username',
              'PASSWORD': 'the.bango.password'}

Solitude also receives requests from Bango. Bango needs to know a URL and a username and password for them. Example:

BANGO_BASIC_AUTH = {'USER': 'a.username',
                    'PASSWORD': 'a.password'}

These are passed to Bango each time a package is created.

You can fake out Bango for some tasks if you’d like:


Braintree settings

To process payments for Braintree, you will need to get a Braintree account. For development, use a Braintree sandbox account.

Then go to Account > My User > API Keys.

These values can be set as environment variables (recommended if you’re running in Docker):

export BRAINTREE_MERCHANT_ID=your-merchant-id
export BRAINTREE_PUBLIC_KEY=your-public-key
export BRAINTREE_PRIVATE_KEY=your-private-key

Alternatively you can add them to your local python configuration file:

BRAINTREE_MERCHANT_ID = 'your-merchant-id'
BRAINTREE_PUBLIC_KEY = 'your-public-key'
BRAINTREE_PRIVATE_KEY = 'your-private-key'

The Braintree API server is configured by this setting:


Zippy settings

Solitude supports zippy by default. If you’d like to use a server other than paas, then alter ZIPPY_CONFIGURATION, for example:

    'reference': {
        'url': 'http://localhost:8080',
        'auth': {'key': 'a.key',
                 'secret': 'a.secret',
                 'realm': 'a.realm'}
  • reference: this is the name of the zippy implementation. Its used as the key for the URLs.
  • url: the location of the zippy server.
  • auth: the key, secret and realm used for calculating the oAuth. Zippy must have the same configuration.

Optional settings

  • DUMP_REQUESTS: True or False. Will dump to the s.dump log: incoming requests, outgoing requests and incoming responses.
  • CLEANSED_SETTINGS_ACCESS: True or False. Will give you access to the cleansed settings in the django.conf.settings through the API. Should be False on production.