This lesson is known to work with hydra-head version 6.0.0.
Please update this wiki to reflect any other versions that have been tested.

Goals

• Create your new Ruby on Rails Application

Explanation

Note: This lesson is basically equivalent to the Getting Started step in the RailsBridge Curriculum.

This lesson assumes you are using a 3.x version of rails, not rails 4.x. To avoid confusion, it's better to have a clean gemset with only the 3.x version of rails installed. Most people use either RVM or rbenv to handle gemsets and ruby versions.

The first step to creating a Hydra Head, or any other type of Rails Application, is to generate the basic skeleton of the application code.

Steps

Once you have installed a suitable rails gem (any 3.x release -- not rails 4.x or higher), begin by using it to generate a new rails application. You can choose any name for your application. In this tutorial we are calling it hydra-demo

$> rails new hydra-demo

This generates the file structure for an empty rails application. And it runs 'bundler' which loads in all of the external dependencies for rails.

Enter the directory for the new rails app: cd hydra-demo, then you should see a file structure like this:

$> ls
Gemfile		Rakefile	config.ru	lib		script		vendor
Gemfile.lock	app		db		log		test
README.rdoc	config		doc		public		tmp

Extra Step (LINUX ONLY): Enable javascript runtime

LINUX ONLY find the line in your Gemfile that has # gem 'therubyracer', :platforms => :ruby and uncomment that line. This allows your system to identify the appropriate javascript runtime.

Now save the Gemfile and run bundle install. This tells bundler to update your dependencies to reflect the change in your Gemfile.

Next Step

Go on to Lesson: Create a git Repository or return to the Dive into Hydra page.