Setup for OSX

1. Install homebrew
2. brew install node
3. brew install mongodb
4. git clone https://github.com/Longhouse-Games/guerrilla-checkers.git
5. cd guerrilla-checkers
6. npm install
7. gem install foreman
8. Fill out your .env file:

DISABLE_CAS=true # set to false to hit the CAS host specified by CAS_HOST and CAS_HOST_FALLBACK
CAS_HOST="ask someone"
CAS_HOST_FALLBACK="ask someone"
EGS_HOST="localhost" # if running the liferay stub, use localhost
EGS_PORT="4000" # if running the liferay stub, it listens on this port
EGS_USERNAME="ask someone" # not needed for liferay stub
EGS_PASSWORD="ask someone" # not needed for liferay stub
PREFIX="/guerrilla-checkers"
PORT=3000

1. foreman run
2. open http://localhost:3000/guerrilla-checkers/new?guerrillas=foo&coin=bar&fmt=html&dbg=1

Liferay Stub

The Liferay stub is defined in Raven and mimics the behaviour of the ECCO liferay server. This includes retrieving player profiles and sending game updates. By default the following users are defined:

1. foo
2. bar

If DISABLE_CAS=true in your .env file is not set, these user accounts must be created on your CAS server.

Running the Server

1. foreman run
2. or, to start it but not run the liferay-stub: foreman start -c liferay=0

Deployment

It's best to run the server on port 843. AVAST and a few other Antivirus programs block websockets and XHR polling on other ports. 843 offers maximum compatibility.

Behind a proxy, add this to your .env file:

SERVICE_URL="https://localhost" # should be the external URL of the app

You can use foreman to get upstart/runit/bluepill/inittab entries for the services. See more here: http://blog.daviddollar.org/2011/05/06/introducing-foreman.html