Skip to content
This repository has been archived by the owner on Mar 27, 2022. It is now read-only.

Using Vagrant

Jump to bottom
Tim Morgan edited this page Jan 25, 2015 · 14 revisions

Vagrant is great. With it you can easily get OneBody running on your local PC or Mac without having to install all the necessary software. You can be hacking on open source software in only a few minutes!

Vagrant is free and runs on Windows, Mac, and Linux.

  1. Install VirtualBox. It's free and it runs on Windows, Mac, and Linux.
  2. Install Vagrant on your host machine.
  3. Install Git.
  4. Clone the repository to your host machine: git clone git://github.com/churchio/onebody.git (If you're on Mac, you can use GitHub for Mac. If you're on Windows, you can use GitHub for Windows.)
  5. In your host terminal, change to the project directory: cd onebody
  6. Run vagrant: vagrant up

Now visit the site running in development mode at http://localhost:8080.

Use Your Editor

You can use your favorite text editor to make changes inside the onebody directory. Changes should show in your browser after refreshing.

Updating Gems & Running Migrations

Whenever gems are updated or new migrations are needed, you can just run vagrant provision.

Getting a Terminal Inside the VM

To gain access to the vagrant box terminal, run vagrant ssh to get an active SSH session. Once inside, the OneBody directory is mirrored at /vagrant inside the Vagrant box.

Restarting the Rails Server

To restart the Rails server, type touch tmp/restart.txt. Or you can vagrant reload to restart the dev box.

Vagrant Docs

For more help with Vagrant, check out the Vagrant docs.

Clone this wiki locally