README.md

# What's this?

This is web software for managing the relations between co-operative makers and their equipment and groups.

# Dependencies

• all the packages in requirements.pip
• nginx (or your own server, if you'd like to use that instead)

# Do Setup

Set up virtualenv using requirements.pip:

virtualenv ~/virtualenv_directory_wherever
source ~/virtualenv_directory_wherever/bin/activate
pip install -r requirements.pip

Next, set up local_settings.py based on local_settings.py.example.

After doing this, if you're making a fresh database, you need to do (using your virtualenv, in the code directory):

python manage.py syncdb --all
python manage.py migrate --fake

If you are not doing a fresh install, please see the section After Update below rather than using the above commands.

# Generate Scripts/Configs

• configure some options... (see -h for what they are ahead of time, if you like)

Like so:

./configure

If that's not OK, use ./configure -h to determine what you need to do to change things. It's suggested to run with -d (working directory) set to something other than the current directory, to avoid cluttering the code dir. Next, configure the config files for nginx and the script for running uwsgi:

make

# Running

Once the setup is complete, run uwsgi and nginx, like so (you'll need these to stay running, but how you do that is up to you):

## uwsgi

While using your virtualenv:

./runuwsgi

## nginx

In the code directory:

./runnginx

# After Update

Once you have a running install, and you get the latest, you'll of course want to do a make. This will make sure your scripts are up to date. You'll also need to update your Django database schemas. To do this, you'll want to run (using your virtualenv, which is of course updated/rebuilt if need be, right?)

python manage.py syncdb
python manage.py migrate