grecia/docs/en/installation

Local installation

Before installing Consul and having it up and running make sure you have Ruby 2.3.2 installed in your local environment.

1. First, clone the Consul Github repository:

git clone https://github.com/consul/consul.git

2. Go to the project folder and install the gems stack using Bundler:

cd consul
bundle install

3. Copy the environment example configuration files inside new readable ones:

cp config/database.yml.example config/database.yml
cp config/secrets.yml.example config/secrets.yml

4. Run the following Rake tasks to fill your local database with the minimum data to run the application:

bin/rake db:setup
bin/rake db:dev_seed
RAILS_ENV=test rake db:setup

5. Now you have all set, run the application:

rails s

Congratulations! Your local Consul application will be running now at http://localhost:3000.

In case you want to access the local application as admin, a default user with admin permissions was created by the seed files with username admin@consul.dev and password 12345678.

If you need an specific user to perform actions such as voting, a default verified user is also available with username verified@consul.dev and password 12345678.