A short guide to setting up Rails 4 with MongoDB and Mongoid
If you've never checked out MongoDB before, I'd very much encourage you to. It's a NoSQL document store that makes for a very interesting method of development compared to relational databases. We've been using it a lot lately for prototyping at Efeqdev and have thoroughly enjoyed it. Today we're going to walk through installing it on Ubuntu and setting up Rails with MongoDB and Mongoid to replace ActiveRecord.
First let's install MongoDB from their official repository:
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv 7F0CEB10 sudo echo "deb http://downloads-distro.mongodb.org/repo/ubuntu-upstart dist 10gen" | tee -a /etc/apt/sources.list.d/10gen.list sudo apt-get -y update sudo apt-get -y install mongodb-10gen
If you run
mongo in your shell you should get an interactive database prompt:
MongoDB shell version: 2.4.6 connecting to: test >
Next you're going to need to generate your Rails application with
rails new myapp --skip-active-record. The
--skip-active-record is important because it doesn't include ActiveRecord in the app that is generated. We need to modify the Gemfile to remove sqlite3 and add Mongoid.
You'll want to delete these lines from your
# Use sqlite3 as the database for Active Record gem 'sqlite3'
And add these:
gem 'mongoid', '~> 4', github: 'mongoid/mongoid' gem 'bson_ext'
The mongoid gem that supports Rails 4 hasn't been fully published yet so we're using it directly from their Github repository. Now that these are added you can run
bundle to install the gems for your Rails app.
Now we need to generate the Mongoid configuration file that is very much like your
config/database.yml that you may be used to with ActiveRecord. We'll create the mongoid file by running the following command:
rails g mongoid:config
config/mongoid.yml which you can take a look at and make any configuration changes as necessary.
And that's all there is to it! While it's much more work than you might expect, I imagine this will become a smoother process in the future once the Rails 4 gem has been released. Be sure to check out Mongoid's documentation for more information on how to use it.
Join 20,000+ developers who get early access to new screencasts, articles, guides, updates, and more.