Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: 1-0-stable
Fetching contributors…

Cannot retrieve contributors at this time

file 88 lines (47 sloc) 2.978 kb

Installing Refinery Prerequisites

This guide covers getting your system ready for Refinery. Afterwards you will have:

  • A working version of Ruby
  • ImageMagick installed
  • Either the SQLite, MySQL, or PostgreSQL database configured

endprologue.

Checklist

If you are already a Rails developer, you will most likely not have to install anything else. Here’s the requirements for Refinery:

  • Ruby – 1.8.7, 1.9.2, Rubinius, and JRuby are all acceptable
  • RubyGems – Recommended that you have the latest version installed
  • Database – SQLite3 (default), MySQL, or PostgreSQL
  • ImageMagick – Recommended that you have the latest version installed

If you have all of these things, great! Proceed on to the Getting Started with Refinery guide.

Otherwise, choose your operating system below.

Ubuntu

Ruby

TIP. If you’re planning on using Ruby a lot, the best way to install it is using the Ruby Version Manager (RVM)

sudo apt-get install ruby

WARNING. Do not install Ruby 1.9.1, there is a known bug which will not allow Refinery to work.

RubyGems

TIP. If you used RVM above then this step will not be necessary.

sudo apt-get install rubygems

Database

For SQLite:

sudo apt-get install sqlite3 libsqlite3-dev

For MySQL:

sudo apt-get install mysql-client mysql-server libmysqlclient-dev

ImageMagick

sudo apt-get install imagemagick

Mac OS X

Ruby and Rubygems

TIP. If you’re planning on using Ruby a lot, the best way to install it is using the Ruby Version Manager (RVM)

Ruby 1.8.7 and Rubygems come installed by default on a mac. Lucky you!

Database

SQLite is most likely already installed.

ImageMagick

Use this shell script: https://github.com/maddox/magick-installer .

Windows

Ruby and Rubygems

http://www.railsinstaller.org/ provides a great installer to get you up and running in no time. Just download the kit and follow through the installer.

Database

If you used Rails Installer, then SQLite will have been installed by default. For MySQL, follow the instructions at the MySQL website: http://www.mysql.com/downloads/mysql/

ImageMagick

Warning. ImageMagick is tricky to install on windows. Make sure to read the instructions carefully, and if one version does not work for you try an older version as well.

Follow the instructions at http://www.imagemagick.org/script/binary-releases.php#windows

Ready to Install!

Easier than expected right? Now you’re ready to start building great websites with Refinery! Proceed on to the Getting Started with Refinery guide.

Something went wrong with that request. Please try again.