Clone this wiki locally
For Upgrading to 1.0 see these instructions: https://gist.github.com/1540782
If you need more specific instructions refer to the system specific articles.
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:
If you see some output that includes 1.8.7 you can skip this step. Radiant versions 1.0 and newer will also run on Ruby 1.9.2 or 1.9.3.
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
PATH. A Google search for "setting PATH" followed by the name of your operating system should get you plenty of help.
The Ruby Lang website has instructions for installing Ruby on a variety of systems, the current Radiant release is recommended to be run on 1.8.7. Support for Ruby 1.9.2+ is included in with Radiant 1.0.
Ruby Enterprise Edition
An alternative to the official Ruby package is Ruby Enterprise Edition. The latest version of Ruby Enterprise Edition runs Radiant without issue. Refer to the REE documentation for installation instructions.
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:
If you see some output that includes a 1.3.7 or higher version number you can skip this step.
If you see some output but the version number is lower than 1.3.7 then you need to upgrade your RubyGems installation. Refer to the RubyGems download page for instructions.
If you don't see any output you'll need to install the latest version of RubyGems. Refer to the RubyGems download page for instructions.
Ruby on Rails
Radiant versions less than 1.x vendor Rails so you do not need to install it. Versions 1.x and greater will install the appropriate version of Rails as part of the
gem install radiant process.
The Radiant Gem
Once you have Ruby and RubyGems installed the Radiant gem can be installed by running:
gem install radiant
Depending on your system you may need to install the gem with sudo.
sudo gem install radiant
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
radiant --help for details.
# Radiant 1.x radiant ~/project_name # uses sqlite by default cd ~/project_name bundle install bundle exec rake db:bootstrap bundle exec script/server # Radiant 0.x radiant -d sqlite3 ~/project_name cd ~/project_name rake db:bootstrap script/server