Skip to content

INSTALL.md

Latest commit

 

History

History
46 lines (28 loc) · 1.34 KB

INSTALL.md

File metadata and controls

46 lines (28 loc) · 1.34 KB

Installation

March 16, 2021

Ideally, this project will be deprecated soon. However, if you still need to install it, see the following instructions before reaching out for debugging help.

  1. Make sure you have Ruby 2.x.x installed and not 3.0.0+

Check this with the command ruby -v

If you have Ruby version 3.x.x, the project will not work. Details on how to change your Ruby version here. The latest stable 2.x.x version as of the time of this post is 2.7.2, which should work fine.

  1. Delete Gemfile.lock

  2. Run bundle install inside this directory

  3. If you run into issues (most people do on the first try) attempt the following:

gem install bundler:1.17.3
bundle _1.17.3_ install
bundle _1.17.3_ exec middleman build

If successful, run bundle exec middleman server and navigate to localhost:4567

Issue with json gem

Try replacing gem 'json', github: 'flori/json', branch: 'v1.8' in Gemfile with gem 'json', '>= 1.8'. Run bundle install again.

...Reason: Image not found (Mac)

Try these commands:

rvm pkg install openssl
rvm remove 2.7.0
rvm install 2.7.0 --with-openssl-dir=$HOME/.rvm/usr
gem install bundler

Then start from step 1 again.

Help

I'm no longer involved with CUSD, but if nothing in this post works, feel free to reach out via email or private message.