-
Notifications
You must be signed in to change notification settings - Fork 242
Common Issues
Rick Carlino edited this page Jan 20, 2015
·
11 revisions
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 dependencylibv8
.Explicitly building this version of the libv8 gem can help, as explained on this StackOverflow post.Try runningbundle update libv8
before runningbundle install
.
- If you are running OSX Mavericks or Yosemite (10.9 or 10.10)
-
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.
- LINUX USERS: Run
-
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 runningmonogod -dbpath db
in your OpenFarm directory, or better yet, if you use Homebrew runbrew services start mongodb
. To see your list of currently running brew background services runbrew services list
.
- 500 errors can happen for a myriad of reasons. If you just started running a server by executing
- This is a problem with Elasticsearch. It's either not running on your system, or if it is (if
curl http://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://127.0.0.1:9200'
inapp_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
About OpenFarm
Development
- How to Contribute to OpenFarm
- Code of Conduct
- How to Install & Run OpenFarm on an OS X system and on an Ubuntu System
- Troubleshooting Common Issues
- How to Set Up an Amazon S3 Bucket for Use with OpenFarm
- Modular CSS
- The OpenFarm API and API Documentation
- How to Use Docker and Fig
Deployment
Reference