Getting Started: Visit our Community Page
CLA: [Please register an account & sign our CLA.] (http://community.quill.org/signup/cla/)
The Mailing List, Chat, Issues, and Docs can all be accessed from the community page.
Here is a guide to Empirical Core that makes installation and setup easy.
If you want a simple guide to install Empirical Core, then you've come to the right place! Here's the step-by-step process to get Empirical Core running on your system:
-
Download and install rbenv (or a Ruby version manager of your choice). You need to install Ruby version 2.2.2 to properly use Empirical Core. The best way to do this is follow the README and wiki of whatever Ruby version manager you download, but if you decide to use rbenv, then homebrew has a really great and easy-to-use setup and install process:
-
brew update
-
brew install rbenv ruby-build
-
echo 'eval "$(rbenv init -)"' >> ~/.bash_profile
-
Close and reopen your terminal.
-
Download and install postgres, the database engine Empirical Core uses. The easiest way to get started with this is to download postgres.app. If you're more comfortable with installing custom software, you can use homebrew to download and install postgres instead:
-
brew update
-
brew install postgres
-
Follow the instructions on the resulting info screen.
-
Clone the Empirical Core project. Navigate to whatever directory you'd like Empirical Core to live in, and then use
git clone https://github.com/empirical-org/Empirical-Core.git
. From here on in, all the commands you have to type should be in the new Empirical Core directory you just downloaded, so you should probablycd Empirical-Core
. -
Install Redis. You can either download it directly, or you can use homebrew instead:
brew update
brew install redis
-
To run
js: true
/:js
-taggedfeature
specs, install PhantomJS -
Install bundler with
gem install bundler
-
Install the bundle with
bundle install
. -
Set up your database with
bin/rake empirical:setup
. -
Run Redis with
redis-server
-
Run the server with
bundle exec rails s
.
- Navigate your browser to localhost:3000 and you should see Empirical-Core pull up properly!
- When you're done with the server, use Ctrl-C to break it and return to your commandline.
- Run
bin/guard
to have Guard run specs when you save files.
The installation comes with three users, though you can create as many more as you like:
- A teacher, username
teacher
and passwordteacher
. - A student, username
student
and passwordstudent
. - An admin, username
admin
and passwordadmin
.