The website behind Open Plaques
This project requires:
- Ruby (version as specified in the
Gemfile
) - Postgres
- Bundler (installable with
gem install bundler
)
-
Windows may be slightly more difficult
-
gem install curb --version 0.8.6 --platform=ruby -- -- --with-curl-lib="C:/curl-7.24.0-devel-mingw32/bin" --with-curl-include="C:/curl-7.24.0-devel-mingw32/include"
-
Copy
example.env
to.env
– this file is used for configuring environment variables. -
Add a random value for
SECRET_KEY_BASE
in the.env
file. You can generate this by runningbundle exec rake secret
on the command line. -
Copy
database.example.yml
todatabase.yml
. -
Create two databases for development and testing, and specify these in the
database.yml
file. -
Run
bundle install
to install Gem dependencies. -
Run
bundle exec rake db:setup
to setup the database.
This should just be a case of running foreman start
on the command line. The output will tell you which URL
you can view it at. Typically this will be http://localhost:5000
.
When changes to the database schema are required (which you will be warned about), you can make these
changes by running bundle exec rake db:migrate
.
You can run the tests (which check that the code does what we expect it to do) by running bundle exec rspec
.
If you see 0 failures
then everything is ok.