Skip to content

Latest commit

 

History

History
118 lines (78 loc) · 3.98 KB

environment-setup.md

File metadata and controls

118 lines (78 loc) · 3.98 KB
Raw

Environment Setup

These docs support OSX and Debian based OS's only from Debian 8 Jessie onwards (this would include Ubuntu 14.04LTS onwards), but instructions should map easily to other distrubutions.

Dev Environment Requirements

OSX

These are only necessary for OS X devs. You will need Xcode, Xcode command line tools, and brew.

For some completely unfathomable reason, OS X does not ship with the GCC compiler installed. And for further unfathomable reasons, it is bundled with XCode, which is over a GB in size and not installed by default. The upshot is, to get brew to work, you need both Xcode and Xcode command line tools installed. Start the Xcode download early, it can take an hour or more depending on your connection!

Next, install brew!

Install the wget tool, which is not installed on OS X by default:

  • brew install wget

Linux

(Dev environment instructions for Linux missing)

Pip and Virtualenv

Pip is Python's package manager, and virtualenv is a tool that lets you create self-contained environments for sets of python libraries.

Each virtualenv contains its own install of pip, but you need pip to be installed globally in order to install virtualenv and virtualenvwrapper (or, at least, this is the easiest way to get those dependencies).

optionally remove old/crusty versions:

  • sudo apt-get purge python-pip

then get current version (url from http://www.pip-installer.org/en/latest/installing.html)

  • cd /tmp
  • wget https://raw.github.com/pypa/pip/master/contrib/get-pip.py
  • sudo python get-pip.py

optionally verify your install

  • pip --version

install virtualenv and (if you want to stay sane) virtualenvwrapper:

  • sudo pip install virtualenv (harmless if virtualenv is already installed)
  • sudo pip install virtualenvwrapper

add these to your /.bashrc (/.bash_profile if one OS X) (create this file if it doesn't exist):

  • export WORKON_HOME="~/envs" (or whatever you want to name the directory)
  • source /usr/local/bin/virtualenvwrapper.sh (the path should match the path printed by the pip installer for virtualenvwrapper).

don't forget to source the bashrc file now:

  • source ~/.bashrc (or source ~/.bash_profile if that's the file you used)

Node

OSX

???

Debian

Install npm e.g. as per https://www.digitalocean.com/community/tutorials/how-to-install-node-js-on-debian-

Required Libs:

OSX

???

Debian

sudo apt-get install python-dev libxslt-dev libxml2-dev node-less

PIL

PIL is a requirement, but in order for it to compile with JPG support, you must have a system-wide library called libjpeg62-dev.

OS X

Install the missing libjpeg library. You will need X Code installed with the extra "command line tools" component as described above.

  • cd /tmp
  • Download the package at http://www.ijg.org/files/jpegsrc.v8c.tar.gz to the /tmp directory.
  • Unpack this package (tar -xzvf jpegsrc.v8c.tar.gz) and cd into the unpacked folder cd jpeg-8c
  • Compile and install it:
    • ./configure
    • make
    • sudo make install

Then either install PIL using brew, or from the dmg's available on the PIL website. for example, see the process outlined here

Debian

  • sudo apt-get install libjpeg62-turbo-dev

Old docs, not required for jessie? remove this section?

you may need to symlink these libraries for PIL to find them during the install:

sudo ln -s /usr/lib/x86_64-linux-gnu/libfreetype.so /usr/lib/ sudo ln -s /usr/lib/x86_64-linux-gnu/libz.so /usr/lib/ sudo ln -s /usr/lib/x86_64-linux-gnu/libjpeg.so /usr/lib/

Supporting Services

PostgreSQL

OSX: brew update; brew install postgresql

Debian: sudo apt-get install postgresql libpq-dev

Hooray!

Now you can follow the directions in how-to-run