Vagrant Rails Development Box

Based off projects: https://github.com/jackdb/pg-app-dev-vm and https://github.com/kiere/vagrant-heroku-cedar-14

Includes Heroku's Cedar-14 stack and SQLite. The goal is getting your Rails app running in a virtual machine as fast as possible, and to deploy with no surprises. This box also uses zsh as the default shell.

• Ubuntu 14.04
• PostgreSQL 9.4
• SQLite
• NodeJS 0.10.25 (for ExecJS)
• Ruby (currently 2.2.1)
• Rubygems (currently 2.4.5)
• Imagemagick
• Phantomjs (for poltergeist gem)

To get started, clone this project.

$ git clone https://github.com/mwiley/vagrant-rails.git

This box is also available on Atlas. Using this method, you will have to manually add forwarded ports to your Vagrantfile, and download the Procfile and databases.yml files from this repository.

$ vagrant init mwiley/vagrant-rails

Running a Rails app

$ vagrant up
$ vagrant ssh
$ rails new rails-test
$ cd rails-test
$ rails s -b 0.0.0.0

Navigate to http://localhost:3000 in your browser and you should see the default Rails page.

Using PostgreSQL

SQLite is included for convenience, but you should configure PostgreSQL to keep consistent with the production environment.

Add the gem to your Gemfile.

source 'https://rubygems.org'
...
gem 'pg'
...

$ bundle

Overwrite the default config/databases.yml with the one provided.

$ cp config/pg_database.yml config/database.yml

Using the Foreman gem

Foreman is a gem that executes your app in the same way it will be when deployed. More information is available here.

Add the Puma gem to your Gemfile. This is the webserver that Heroku will use to run your app. The Procfile is included.

source 'https://rubygems.org'
...
gem 'puma'
...

$ bundle

Start the server. As a bonus, this command is easier to type than 'rails s -b 0.0.0.0'.

$ foreman start

Foreman runs the webserver at http://localhost:5000.

Refer to this page for instructions on how to deploy to Heroku.