Files
grecia/docs/en/getting_started/local_installation.md
Javi Martín 924503fa09 Simplify installation commands
Sometimes running `bin/rake db:create` doesn't work properly returning
an error message about a database not existing. So we'll execute `rake`.
New users should only have one version of `rake` installed, so executing
`rake` will work fine.

On the other hand, the opposite happens sometimes when executing `rails
s`. So executing `bin/rails s` works in every case.
2019-04-01 21:10:29 +02:00

1.6 KiB

Local installation

Before installing Consul and having it up and running make sure you all prerequisites installed.

  1. First, clone the Consul Github repository:
git clone https://github.com/consul/consul.git
  1. Go to the project folder and install the gems stack using Bundler:
cd consul
bundle
  1. 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

And setup database credentials with your consul user in your new database.yml file.

  1. Run the following Rake tasks to create and fill your local database with the minimum data to run the application:
rake db:create
rake db:setup
rake db:dev_seed
rake db:test:prepare
  1. Check everything is fine by running the test suite (beware it might take more than an hour):
bin/rspec
  1. Now you have all set, run the application:
bin/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 verified and 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 without admin permissions, a default verified user is also available with username verified@consul.dev and password 12345678.