====== Installing Refinery CMS ======

[[https://www.gandi.net/hosting/simple?language=ruby&db=mysql|{{:fr:tutorials:simple:ruby.png?nolink|}}]]{{:fr:tutorials:simple:plus.png?nolink|}}[[https://www.gandi.net/hosting/simple?language=ruby&db=mysql|{{:fr:tutorials:simple:mysql.png?nolink|}}]]{{:fr:tutorials:simple:slash.png?nolink|}}[[https://www.gandi.net/hosting/simple?language=ruby&db=mysql|{{:fr:tutorials:simple:pgsql.png?nolink|}}]]

The following tutorial will show you how to set up Refinery CMS on a Ruby Simple Hosting instance.

<code>
$ rvm --default 1.9.3
</code>

First, install Refinery CMS on your local machine:

<code>
$ gem install refinerycms
</code>

Refinery CMS needs ''execjs'' and a JavaScript execution environment. You can use ''therubyracer'':

<code>
gem install execjs
gem install therubyracer
</code>

Then, create a new application by indicating your working directory:

<code>
$ refinerycms /path/to/repo
</code>

Navigate to the directory where the application's code is located:

<code>
cd /path/to/repo
</code>

Before building the ''Gemfile.lock'' file containing the dependencies, it's necessary to indicate the ''execjs'' and ''therubyracer'' dependencies in the file ''Gemfile'', and to modify it according the the type of database you chose for the instance:

For MySQL:

<code>
--
file: Gemfile
--

source 'https://rubygems.org'

gem 'rails', '3.2.18'
gem 'mysql2'
gem 'execjs'
gem 'therubyracer'
[...]
</code>

For PostgreSQL :

<code>
--
file: Gemfile
--

source 'https://rubygems.org'

gem 'rails', '3.2.18'
gem 'pg'
gem 'execjs'
gem 'therubyracer'
[...]
</code>

===== Database configuration =====

Next, configure the database for the production environment:

For MySQL:

<code>
--
file: config/database.yml
--

[...]
production:
  adapter: mysql2
  database: refinery
  socket: /srv/run/mysqld/mysqld.sock
  username: root
  password:
  encoding: utf8
  pool: 5
[...]
</code>

For PostgreSQL:
<code>
--
file: config/database.yml
--

[...]
production:
  adapter: postgresql
  template: template0
  database: refinery
  host: localhost
  port: 5432
  username: hosting-db
  password: 
  encoding: unicode
  pool: 5
[...]
</code>

Finally, we build the dependency file ''Gemfile.lock'':

<code>
$ bundle install
</code>

===== Push to the instance =====

Now you can push the code to the instance:

<note tip>
In the commands below, replace ''LOGIN'' with your login, ''INSTANCE_ID'' with your instance ID, and and ''DC_ID'' with the ID of the datacenter where your instance lives (''dc0'' for Paris, ''dc1'' for Baltimore, ''dc2'' for Luxembourg).
</note>

<code>
$ git init 
$ git add .
$ git commit -am 'First install'
$ git remote add gandi git+ssh://LOGIN@git.DC_ID.gpaas.net/default.git
$ git push gandi master
$ ssh INSTANCE_ID@git.DC_ID.gpaas.net 'deploy default.git'
</code>

===== Deploy the application =====

Lastly, activate the SSH console from the instance control panel.

Connect via ssh, and execute the following command to initialize the database:

<code>
$ cd web/vhosts/default
$ rake db:setup
</code>