Skip to content
bholtsclaw edited this page Jan 20, 2012 · 14 revisions

With this guide, using OSX, you could install Locker for yourself at this very early stage to try it out.

Start by getting Git

Git is used to get Locker. It's also used to contribute to Locker. Git is great. Go get git.

a) Using Homebrew

If you have Homebrew installed, you can just do:

brew install git

b) Manually

Install the latest Git for OS X.

Get XCode (Developer Tools)

Go to the Apple Store, search for "Xcode", download. This is needed for compiling Node.js. It now costs $5.00, even though it was free before the App Store.... >:( ... But lo and behold, if you get Lion first you will get Xcode 4.1 for free :)

Install Node.js

You have two options. (zencuke: Nov 26, 2011: At the root page of nodejs.org see "node-v0.6.3.pkg Macintosh installer" for a simpler option. Warning: I haven't tested whether it works for locker. If I ever work through the multiple layers of OSX Lion locker install problems I will update this note. Update: This version of node does NOT work with Locker. Locker currently {as of Nov 27} requires node between 0.4.5-0.4.9. If you install using brew make sure it gives you an acceptable version. I finally went to the 'Manual tarball' option because it allowed me to choose the version. Do not "grab the latest version" as suggested below.)

a) Using Homebrew

If you have Homebrew installed, you can just do:

brew install node

b) Manually

http://nodejs.org/#download

Grab the latest tar.gz; e.g.:

curl -o node.tgz http://nodejs.org/dist/node-v0.4.7.tar.gz

cd node-v0.4.7/

So I read README.md. Looks like the usual drill of ./configure; make; make install.

./configure

make

Some warnings about directory not found for option '-Lusr/local/lib'. Hopefully that won't stop me.

Going to try make test to test to see if it works as the node guys expect node to.

make test

Crap, one of the test failed... "simple/test-http-dns-fail". Hope that's not critical for Locker.

make install

Eep

Cannot create folder '/usr/local/include/node/' (original error: [Errno 13] Permission denied: '/usr/local/include')

Lets do that with sudo, if it works for sandwiches...

Yay! 'install' finished successfully (0.256s)

Install MongoDB

a) Using Homebrew

If you have Homebrew installed, you can just do:

brew install mongodb

And follow the rest of the installation instructions displayed on the screen.

Install NPM, the Node Package Manager

This is for node packages. Yummy yummy nodey packages.

curl -o install_npm.sh http://npmjs.org/install.sh

sudo sh install_npm.sh

Install clucene, the search library we're using

Using Homebrew

If you have Homebrew installed, you can just do:

brew install clucene --HEAD

Okay, now we can install Locker!

git clone https://github.com/LockerProject/Locker.git

cd Locker

Yay, downloaded (cloned) it directly from github.com. Now I have my own personal Locker platform to run with.

We need to set it up though...

npm install

python setupEnv.py (unless you have a homebrew version of Python you may need to sudo this.)

node lockerd.js

Hot damn, it's up! Now to go to http://localhost:8042 to access it with Chrome.

Clone this wiki locally