Installation manual

Ruby

Example with rvm (other solutions : rbenv, packages..):

rvm install 2.3.5

Nokogiri on macOS

http://www.nokogiri.org/tutorials/installing_nokogiri.html tells us that xz can cause troubles, here is what to do

brew unlink xz
gem install nokogiri # or bundle install
brew link xz

Node and Yarn

Yarn needs node. If you use Node Version Manager NVM you can rely on the content of .nvmrc. Otherwise please make sure to use a compatible version, still best to use the same as indicated by .nvrmc.

Install node

nvm install 6.13.0

Install yarn

// On macOS
brew install yarn

// On Debian/ubuntu
curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
sudo apt-get update && sudo apt-get install yarn

Install nodes packages

yarn install

Postgres

Create user

  createuser -s -U $USER -P chouette
              ^    ^      ^
              |    |      +---- prompt for passwd
              |    +----- as your default postgres user (remove in case of different config)
              +---------- superuser

When promted for the password enter the highly secure string chouette.

As documented here we need some more libs before we can use database :

On mac/OS :

brew install postgis

On debian/ubuntu system :

sudo apt-get install libproj-dev postgis

Rails

Dependencies

sudo apt-get install libmagickwand-dev

Install gems

Add the bundler gem

gem install bundler

Go into your local repository and install the gems

bundle install

Database

Create database

bundle exec rake db:create db:migrate

Use seed

Run :

bundle exec rake db:seed

Run

Launch Sidekiq

bundle exec sidekiq

bin/webpack-dev-server // Launch webpack server to compile assets on the fly
bundle exec rails server // Launch rails server