Installation & Deployment Guide: Installing Dependencies

If you wish to install Wheelhouse CMS on your local machine or onto a dedicated server or VPS, you may need to install certain dependencies.

Installing Ruby & Rails

You can verify your current Ruby version by opening a terminal window and running:

$ ruby -v
ruby 2.1.0p0 (2013-12-25 revision 44422) [x86_64-darwin12.0]

At a minimum, Wheelhouse requires Ruby 1.9.3 or greater (2.0 or later is recommended). The recommended method to install Ruby is to use RVM (Ruby Version Manager).

These instructions will install RVM and Ruby 2.1.0 in single-user mode (recommended for local development), and will work on Mac OS X, Linux, or any UNIX-like operating system.

$ \curl -sSL https://get.rvm.io | bash -s stable
$ rvm use 2.1.0 --default

Visit https://rvm.io/rvm/install/ for a more detailed guide to installing RVM.

Once you have a working Ruby environment, install Rails and its dependencies by running:

$ gem install rails
...
Successfully installed rails-4.0.3

Rails 3.1.1 or greater is required to run Wheelhouse CMS (4.0.3 or later is recommended). To verify your current Rails version, run:

$ rails -v
Rails 4.0.3

Installing MongoDB

The recommended method for installing MongoDB on Mac OS X is to use Homebrew. The following commands will install Homebrew and MongoDB:

$ ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)"
$ brew install mongodb 

Visit https://github.com/Homebrew/homebrew/wiki/Installation for more details on installing Homebrew. Alternatively you can install MongoDB using MacPorts or by downloading the binaries here.

For other operating systems, you can download the binaries or source code directly from the MongoDB Downloads page or add the 10gen repositories to install pre-built packages. 10gen (the company behind MongoDB) provides packages for Ubuntu and Debian as well as RedHat-based distributions (CentOS and Fedora).

Installing ImageMagick

As with MongoDB, the recommended method to install ImageMagick on Mac OS X is with Homebrew. If you have Homebrew installed, simply run the following to install ImageMagick:

$ brew install imagemagick

Alternatively you can install using MacPorts or by downloading the binaries here.

ImageMagick is included within the default repositories on Ubuntu, Debian, CentOS & Fedora and can be installed using apt-get or yum (package name is imagemagick).