Permalink
Find file
Fetching contributors…
Cannot retrieve contributors at this time
108 lines (75 sloc) 2.95 KB

Optional installs

MySQL

On your dev machine, MySQL probably needs some tweaks. Locate your my.cnf (or create one) then, at the very least, make UTF8 the default encoding:

[mysqld]
character-set-server=utf8

Here are some other helpful settings:

[mysqld]
default-storage-engine=innodb
character-set-server=utf8
skip-sync-frm=OFF
innodb_file_per_table

On Mac OS X with homebrew, put my.cnf in /usr/local/Cellar/mysql/5.5.15/my.cnf then restart like:

launchctl unload -w ~/Library/LaunchAgents/com.mysql.mysqld.plist
launchctl load -w ~/Library/LaunchAgents/com.mysql.mysqld.plist

Note

some of the options above were renamed between MySQL versions

Here are more tips for optimizing MySQL on your dev machine.

Memcached

By default zamboni uses an in memory cache. To install memcached libmemcached-dev on Ubuntu and libmemcached on OS X. Alter your local settings file to use:

CACHES = {
    'default': {
        'BACKEND': 'django.core.cache.backends.memcached.MemcachedCache',
        'LOCATION': ['localhost:11211'],
        'TIMEOUT': 500,
    }
}

RabbitMQ and Celery

By default zamboni automatically processes jobs without needing Celery.

See the :doc:`./celery` page for installation instructions. The :ref:`example settings <example-settings>` set CELERY_ALWAYS_EAGER = True. If you're setting up RabbitMQ and want to use celery worker you will need to alter your local settings file to set this up.

See :doc:`./celery` for more instructions.

Node.js

Node.js is needed for Stylus and LESS, which in turn are needed to precompile the CSS files.

If you want to serve the CSS files from another domain than the webserver, you will need to precompile them. Otherwise you can have them compiled on the fly, using javascript in your browser, if you set LESS_PREPROCESS = False in your local settings.

First, we need to install node and npm:

brew install node
curl http://npmjs.org/install.sh | sh

Optionally make the local scripts available on your path if you don't already have this in your profile:

export PATH="./node_modules/.bin/:${PATH}"
Not working?

Stylus CSS

Learn about Stylus at http://learnboost.github.com/stylus/

cd zamboni
npm install

In your settings_local.py (or settings_local_mkt.py) ensure you are pointing to the correct executable for stylus:

STYLUS_BIN = path('node_modules/stylus/bin/stylus')