Installation

If you need more specific instructions refer to the system specific articles.

Ruby

Many operating systems ship with a compatible version of Ruby installed by default, to check if this is the case for your system open a terminal window and run:

ruby --version

If you see some output with a 1.8.6 or 1.8.7 version number you can skip this step.

If you don’t see any output that means you either don’t have Ruby installed or wherever it is has not been added to your shell environment’s PATH. A Google search for “setting path” followed by the name of your operating system should get you plenty of help.

Official Ruby

The Ruby Lang website has instructions for installing Ruby on a variety of systems, current Radiant is recommended to be run on 1.8.6 or 1.8.7.

Ruby Enterprise Edition

An alternative to the official Ruby package is the Ruby Enterprise Edition from Phusion, the same company that created and maintains Passenger. The latest version of Ruby Enterprise Edition runs Radiant without issue. Refer to the REE documentation for installation instructions.

What About Rails?

You do not need Ruby on Rails installed in order to run Radiant. Radiant ships with its own version of Rails to make deployment easier.

RubyGems

In all likelihood, if you have Ruby installed you have RubyGems installed, although some systems do ship them separately. To determine if you have RubyGems installed go to a terminal window and run:

gem --version

If you see some output that includes a 1.3.0 or higher version number you can skip this step.

If you see some output but the version number is lower than 1.3.0 then you need to upgrade your RubyGems installation. Refer to the RubyGems manual for instructions.

If you don’t see any output you’ll need to install the latest version of RubyGems. Refer to the Installing RubyGems section of the Ruby Lang website for instructions. Note: Ignore that the page refers to version 0.9.0 and get the latest version. Here is a direct link http://rubyforge.org/frs/download.php/45905/rubygems-1.3.1.tgz.

The Radiant Gem

Once you have Ruby and RubyGems installed the Radiant gem can be installed by running:

sudo gem install radiant

This may prompt you to enter your system administrator password.

Creating a New Project

Once you have the Radiant gem installed you can create a new project with the `radiant` command (which is similar to the `rails` command, but Radiant specific). Run the command with the `—help` flag for details:

radiant --help