Note: If you run across any issues getting OpenFarm up and running and solve them please help others by taking a minute to add your instructions, workaround, StackOverflow links, etc here.

##Gem/Bundle Issues

• An error occurred while installing libv8 (3.16.14.3), and Bundler cannot continue.
  • If you are running OSX Mavericks or Yosemite (10.9 or 10.10) therubyracer gem can have trouble installing its dependency libv8. Explicitly building this version of the libv8 gem can help, as explained on this StackOverflow post. Try running bundle update libv8 before running bundle install.
• A Syntax Error in SASS files
  • We haven't identified why, but sprockets 2.11.0 is having some issues. 2.10.1 is known to work.
• Can't install 'patron' gem
  • LINUX USERS: Run sudo apt-get install libcurl4-gnutls-dev on linux machines. Patron requires that as a dependency.
• Tests fail
  • This is probably because your version of rspec is having dependency issues with capybara. This is known to happen with rspec 3.x. Rspec 2.14.8 works.

##Server Errors

• 500 Internal Server Error
  • 500 errors can happen for a myriad of reasons. If you just started running a server by executing rails s and are immediately getting this error, it's likely your mongo database is not running. Start the database by manually running monogod -dbpath db in your OpenFarm directory, or better yet, if you use Homebrew run brew services start mongodb. To see your list of currently running brew background services run brew services list.

• This is a problem with Elasticsearch. It's either not running on your system, or if it is (if curl http:https://localhost:9200 returns a 200 status), we've seen that setting your environnment var to point explicitely to the right location somehow magically cures it: ENV['ELASTICSEARCH_URL'] = 'http:https://127.0.0.1:9200' in app_environment_variables.rb.

• If you have an Amazon AWS account set up and working, one known reason for this is that you might not have installed ImageMagick. brew install ImageMagick if you use homebrew. Else have a look here