Installing Snowy On Your Server

Setting up Snowy should be just like setting up any other Django application on your server. Just remember to follow the latest instructions in the INSTALL file.

Deployment Guides

Some of our users have contributed guides for how they've set up Snowy. They may not all be up-to-date, so if you have any trouble don't hesitate to ask for help on snowy-list, in #snowy on IRC, or in bugzilla.

Our recommended method of install is WSGI on Apache, using MySQL with InnoDB table types (for transaction support, which is vital to stable note sync).

Third-party guides

Distro-specific Notes

Ubuntu Lucid

If Snowy complains about not finding the 'messages' module, or gives any other indication that Django 1.2 is required, you'll need to install Django 1.2 from source or grab it from a backports testing PPA.

sudo add-apt-repository ppa:ubuntu-backports-testers/ppa
sudo apt-get update
sudo apt-get install python-django

Other dependencies (these should be the same on Maverick, I'd imagine):

sudo apt-get install python-tz python-lxml python-sqlite python-dateutil python-pkg-resources python-json python-openid

Of course, you don't need python-sqlite if you use a different database backend like MySQL.

Mac OSX Snow Leopard

These notes show how to install the requirements for snowy on Mac OSX Snow Leopard. After having followed the two steps below you should continue from step 2 in the INSTALL file bundled with snowy.

1. Install Django

To get started you need to fetch the latest django from http://www.djangoproject.com/download/

tar xzvf Django-x.x.x.tar.gz
cd Django-x.x.x.tar.gz
sudo python setup.py install

2. Install the snowy dependencies

To install the packages that snowy requires, and are not included in the bundled python by default, issue the following commands

STATIC_DEPS=true easy_install lxml
easy_install pytz pysqlite simplejson python-openid

Arch Linux

These instructions are for installing Snowy on Arch Linux, but should work in any Unix environment that supports Python 2 and pip.

Snowy does not support Python 3 yet. This guide assumes that you use Python 2.

1. Start by grabbing the source from Git

git clone git://git.gnome.org/snowy

2. Then install the necessary dependencies

pip install django==1.2 lxml pytz south pysqlite python-dateutil uuid simplejson python-openid

3. Proceed from step 2 in the INSTALL file bundled with Snowy

Projects/Snowy/Install (last edited 2013-11-22 20:53:49 by WilliamJonMcCann)