shadowcraft-vm
==============

Vagrant configuration for running Shadowcraft-UI and Shadowcraft-Engine

This configuration is originally based on https://github.com/mulderp/chef-rails-stack.

shadowcraft-vm
==============

Vagrant configuration for running Shadowcraft-UI and Shadowcraft-Engine

This configuration is originally based on https://github.com/mulderp/chef-rails-stack.

## Installation

1. Install Vagrant from http://vagrantup.com
2. Install Virtualbox from http://virtualbox.org
3. Clone this repo
4. Open a command line (cmd.exe, Terminal.app, xterm, etc) and enter the directory of the repo
5. Run the command `vagrant up`.  This will download, install, boot, and provision the VM.
6. Run the command `vagrant ssh`.  This will ssh into the VM that is now running.
7. Start the ShadowCraft UI backend running by running the following commands:
    cd /var/www/shadowcraft-ui/backend
    twistd -ny server-5.4.toc

## Runtime and provisioning edits

The environment can be modified to use other versions of the shadowcraft UI and backend as needed during the provisioning by modifying the shadowcraft-setup.sh file.  If this file is changed after the VM has already been provisioned, you may recreate the VM by running `vagrant destroy` followed by `vagrant up`.  This will completely rebuild the VM, so you'll need to restart the backend again.

The version of ruby/rails/passenger/nginx/etc can be changed by modifying the node.json file.  It currently defaults to the following versions:

ruby: 1.8.7-p374
rails: 3.2.19
nginx: 1.2.5
passenger: 3.0.18

The same destroy/up cycle needs to happen if you change the node.json file as well.

## Running Shadowcraft from the VM

Once the VM is up and configured, you can get to the Shadowcraft UI by opening a web browser on your local machine and going to http://localhost:8080.

Update installation bits in the readme
Update installation bits in the readme
