Getting Started > Prerequisites

To use Adhearsion you will need a few things:

  • A Telephony Engine
  • A Ruby Interpreter

A Telephony Engine

Adhearsion 2 supports the following telephony engines:

A Ruby Interpreter

Adhearsion requires Ruby version 1.9.2 or later. JRuby version 1.7.0 or later is also supported.

Most operating systems come with a version of Ruby installed. However, it is very important to check the version. Mac OS X ships with a version of Ruby based on 1.8.7, which is too old. Debian and its derivatives, including Ubuntu, provide a version of Ruby 1.9 with the package called ruby19.

One easy, cross-platform way to install an acceptable version of Ruby is to use the Ruby Version Manager, also called "RVM".

After you have RVM installed, installing Ruby 1.9.3 with RVM is easy:


$ rvm install 1.9.3
Fetching yaml-0.1.4.tar.gz to /Users/ben/Developer/.rvm/archives
Extracting yaml-0.1.4.tar.gz to /Users/ben/Developer/.rvm/src
Configuring yaml in /Users/ben/Developer/.rvm/src/yaml-0.1.4.
Compiling yaml in /Users/ben/Developer/.rvm/src/yaml-0.1.4.
Installing yaml to /Users/ben/Developer/.rvm/usr
Installing Ruby from source to: /Users/ben/Developer/.rvm/rubies/ruby-1.9.3-p125, this may take a while depending on your cpu(s)...

ruby-1.9.3-p125 - #fetching 
ruby-1.9.3-p125 - #extracting ruby-1.9.3-p125 to /Users/ben/Developer/.rvm/src/ruby-1.9.3-p125
ruby-1.9.3-p125 - #extracted to /Users/ben/Developer/.rvm/src/ruby-1.9.3-p125
Applying patch 'xcode-debugopt-fix-r34840' (located at /Users/ben/Developer/.rvm/patches/ruby/1.9.3/p125/xcode-debugopt-fix-r34840.diff)
ruby-1.9.3-p125 - #autoreconf
ruby-1.9.3-p125 - #configuring 
ruby-1.9.3-p125 - #compiling 
ruby-1.9.3-p125 - #installing 
Removing old Rubygems files...
Installing rubygems-1.8.21 for ruby-1.9.3-p125 ...
Installation of rubygems completed successfully.
ruby-1.9.3-p125 - adjusting #shebangs for (gem irb erb ri rdoc testrb rake).
ruby-1.9.3-p125 - #importing default gemsets (/Users/ben/Developer/.rvm/gemsets/)
Install of ruby-1.9.3-p125 - #complete 
$ rvm use 1.9.3
Using /Users/ben/Developer/.rvm/gems/ruby-1.9.3-p125

If you prefer JRuby, RVM can also install JRuby:


$ rvm install jruby
jruby-1.7.0 - #fetching 
jruby-1.7.0 - #extracting jruby-bin-1.7.0 to /Users/ben/Developer/.rvm/src/jruby-1.7.0
jruby-1.7.0 - #extracted to /Users/ben/Developer/.rvm/src/jruby-1.7.0
Building Nailgun
jruby-1.7.0 - #installing to /Users/ben/Developer/.rvm/rubies/jruby-1.7.0
jruby-1.7.0 - #importing default gemsets (/Users/ben/Developer/.rvm/gemsets/)
Copying across included gems
Building native extensions.  This could take a while...
Successfully installed jruby-launcher-1.0.12-java
1 gem installed
$ rvm use jruby
Using /Users/ben/Developer/.rvm/gems/jruby-1.7.0
Back to Getting Started Continue to Installation

docs-nav-getting-started

blog comments powered by Disqus