Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

135 lines (87 sloc) 4.1 kb

Alchemy CMS

Build Status Maintenance Status Code Climate


This branch is a beta development branch. For productive environments use the current rubygems version, or the latest stable branch (2.4-stable).

Alchemy is a powerful, userfriendly and flexible Rails 3 CMS.

Read more on the website and in the guidelines.


  • Highly flexible Templating
  • Gorgious End-User centric interface
  • Multilingual
  • SEO
  • Access Control
  • Fulltext Search
  • RSS Feeds
  • Contactforms
  • Attachments and downloads
  • Powerful image rendering
  • Extendable
  • Integrates in exsiting Rails Apps
  • Caching
  • BSD License
  • Hostable on any Server that supports RubyOnRails and ImageMagick (Software Requirements)

Rails Version

This version of Alchemy runs with Rails 3.2.8+.

If you are looking for a Rails 3.1 compatible version check the 2.1-stable branch.

If you are looking for a Rails 3.0 compatible version check the 2.0-stable branch.

If you are looking for a Rails 2.3 compatible version check the 1.6-stable branch.

Ruby Version

Alchemy runs with Ruby 1.9.2 and Ruby 1.9.3.

For a Ruby 1.8.7 compatible version use the 2.3-stable branch.


Use the installer (recommended):

gem install alchemy_cms --pre
alchemy new my_magicpage

Start the local server:

rails server

Then just switch to your browser and open http://localhost:3000

Add to existing Rails project

In your Gemfile:

gem 'alchemy_cms', :github => 'magiclabs/alchemy_cms'

Run in terminal:

bundle update
rake alchemy:install

Note: If you did not mounted Alchemy on the root route '/', then you have to add Alchemy's view helpers manually to your app.

Just paste this in your app/controllers/application_controller.rb

helper Alchemy::PagesHelper


After updating Alchemy you should run the upgrader.

Run in terminal:

rake alchemy:upgrade


  1. This generator creates all necessary folders and files needed for creating your own page layouts and elements for your website:

    rails generate alchemy:scaffold
  2. If you use the ferret full text search (enabled by default), then please add a job to your crontab that reindexes the ferret index.

    cd /path/to/your/alchemy && RAILS_ENV=production rake ferret:rebuild_index > /dev/null
  3. You can easily create your element files (for view and editor) depending on the elements.yml with this generator:

    rails generate alchemy:elements --skip




Jump to Line
Something went wrong with that request. Please try again.