= Instalation with RubyGems

1. Download and install RubyGems: 

  http://rubygems.rubyforge.org

2. Install the distribution:

  gem install nitro
  
  If you wish to install Og only:

  gem install og

  (make sure you have the latest stable versions of Ruby and RubyGems
  installed)

  When asked about the dependencies to include, only accept
  the dependencies for the RDBMS backends you are planning
  to use.

3. Set environment variable (required to load RubyGems):

  export RUBYOPT=-rubygems

  You can add this in you .bashrc in Unix.

  Alternatively you can run your applications with the -rubygem 
  option:

  ruby -rubygem xxx.rb

4. To verify that everything works ok, run the command

  nitro

= Installation without RubyGems using script.

Installation without RubyGems is *strongly* discouraged.
However, as Nitro is all about freedom and possibilities,
a standard installation script is provided.

1. Switch to an administrator account 

  For example in Unix:

  $ su -

2. Run the installation script.

  $ ruby install.rb

This installation script also installs some vendor libraries
that you possibly have allready installed. Use with caution.


= Manual installation.

Uncompress your distribution (Unix example):

$ cd my_dir
$ tar xvfz nitro-x.x.x.tar.gz

Put the libray dir in the Ruby path (Unix example):

$ export RUBYOPT='-I path/to/nitro/lib'

or, at windows

> set RUBYOPT=Ic:\dev\nitro\lib;c:\dev\og\lib;c:\dev\glue\lib

You also may have to manualy install the following libraries:

* Nano
* Mega
* RedCloth

= Additional libraries

Nitro uses a number of additional libraries. RubyGems
installs most of them, but here is the complete
list for your reference. Please not that most of these
libraries are optional.

* PostgreSQL 
  http://www.postgres.org
  Used for Database driven web applications.
  
* MySQL 
  http://www.mysql.org
  Used for Database driven web applications.

* Ruby-psql 
  http://www.postgresql.jp/interfaces/ruby/archive/ruby-postgres-0.7.1.tar.gz
  Ruby interface to the PostgreSQL RDBMS.

* Ruby-mysql 
  http://tmtm.org/ja/ruby/mysql/README_en.html
  Ruby interface to the MySQL RDBMS.
  
* Ruby-XSLT 
  http://gregoire.lejeune.free.fr/ruby-xslt_0.4.0.tar.gz
  Used for XSLT based templates.

* Apache 2.0 
  http://www.apache.org
  Used to host application in production environments.  

* Lighttpd
  http://www.lighttpd.net/
  A lean and efficient web server. A perfect companion to Nitro.

* Ruby-fcgi 
  http://www.moonwolf.com/ruby/archive/ruby-fcgi-0.8.5.tar.gz
  Used for FCGI based applications.

* FastCGI development kit
  http://www.fastcgi.com/dist/fcgi.tar.gz
  Needed to compile the C-version of the ruby fcgi library.