Chapters1 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, 1.9.3, 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.
2 Ubuntu
2.1 Ruby
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
Do not install Ruby 1.9.1, there is a known bug which will not allow Refinery to work.
2.2 RubyGems
If you used RVM above then this step will not be necessary.
sudo apt-get install rubygems
2.3 Database
For SQLite:
sudo apt-get install sqlite3 libsqlite3-dev
For MySQL:
sudo apt-get install mysql-client mysql-server libmysqlclient-dev
2.4 ImageMagick
sudo apt-get install imagemagick
3 Mac OS X
3.1 Ruby
The best way to install Ruby is using the Ruby Version Manager (RVM)
Ruby 1.8.7 comes installed by default on a mac. Lucky you!
3.2 Rubygems
Rubygems also comes installed by default, however, it is an old version which will cause problems. Update using:
gem update --system
Also, due to an RDoc bug, you’ll need to update it as well:
gem install rdoc
3.3 Database
SQLite is most likely already installed.
3.4 ImageMagick
Use this shell script: https://github.com/maddox/magick-installer .
4 Windows
4.1 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.
4.2 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/
4.3 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
5 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.