diff --git a/doc/en/dev_test_setup.md b/doc/en/dev_test_setup.md
index 7fc7c967e..d5fa28fe0 100644
--- a/doc/en/dev_test_setup.md
+++ b/doc/en/dev_test_setup.md
@@ -2,6 +2,8 @@
## Linux
+See [here](dev_test_setup_linux.md)
+
## Mac OS X
See [here](dev_test_setup_osx.md)
diff --git a/doc/en/dev_test_setup_linux.md b/doc/en/dev_test_setup_linux.md
new file mode 100644
index 000000000..57b3c1463
--- /dev/null
+++ b/doc/en/dev_test_setup_linux.md
@@ -0,0 +1,118 @@
+# Configuration for development and test environments (GNU/Linux)
+
+## Git
+
+Git is officially maintained in Debian/Ubuntu:
+
+```
+sudo apt-get install git
+```
+
+## Ruby
+
+Ruby versions packaged in official repositories are not suitable to work with consul (at least Debian 7 and 8), so we'll have to install it manually.
+The preferred method is via rvm:
+**be careful as only the multi user option installs all dependencies automatically, as we use 'sudo'.**
+
+###as local user:
+
+```
+$ curl -L https://get.rvm.io | bash -s stable
+```
+###for all system users
+
+```
+$ curl -L https://get.rvm.io | sudo bash -s stable
+```
+and then add your user to rvm group
+```
+$ sudo usermod -a -G rvm
+```
+and finally, add rvm script source to user's bash (~/.bashrc) (this step it's only necessary if you still can't execute rvm command)
+```
+[[ -s /usr/local/rvm/scripts/rvm ]] && source /usr/local/rvm/scripts/rvm
+```
+with all this, you are suppose to be able to install a ruby version from rvm, as for example version 2.3.0:
+```
+rvm install 2.3.0
+```
+
+
+## Bundler
+
+with
+```
+gem install bundler
+```
+or
+there is more methods [here](https://rvm.io/integration/bundler)
+as:
+```
+gem install rubygems-bundler
+```
+should be better
+
+
+## PostgreSQL (>=9.4)
+
+PostgreSQL version 9.4 is not official in debian 7 (wheezy), in 8 it seems to be officially maintained.
+So you have to add a repository, the official postgresql works fine.
+
+Add the repository to apt, for example creating file */etc/apt/sources.list.d/pgdg.list* with:
+```
+deb http://apt.postgresql.org/pub/repos/apt/ wheezy-pgdg main
+```
+afterwards you'll have to download the key, and install it, by:
+
+```
+wget https://www.postgresql.org/media/keys/ACCC4CF8.asc
+apt-key add ACCC4CF8.asc
+```
+and install postgresql
+
+```
+apt-get update
+apt-get install postgresql-9.4
+```
+
+## Ghostscript
+
+```
+apt-get install ghostscript
+```
+
+## Cloning the repository
+
+Now, with all the dependencies installed, clone the Consul repository:
+
+```
+git clone https://github.com/consul/consul.git
+cd consul
+bundle install
+cp config/database.yml.example config/database.yml
+cp config/secrets.yml.example config/secrets.yml
+```
+Perhaps it's needed to create a superuser rol with password in postgresql, and write it in */config/database.yml* 'user:' and 'password:' fields.
+
+Also, it seems that postgresql use as default an unix socket for localhost communications. If we encounter problems creating database (connection problems) we can change in */config/database.yml* the line:
+```
+host: localhost
+```
+for:
+```
+host: /var/run/postgresql
+```
+
+After this:
+
+```
+rake db:create
+rake db:setup
+rake db:dev_seed
+RAILS_ENV=test bin/rake db:setup
+```
+
+and run it in test mode by executing
+```
+bin/rails -s
+```
\ No newline at end of file