diff --git a/LOCAL_SETUP.md b/LOCAL_SETUP.md
new file mode 100644
index 00000000..2394b3c8
--- /dev/null
+++ b/LOCAL_SETUP.md
@@ -0,0 +1,76 @@
+
+
+Install prerequisites
+On Mac: install brew - http://brew.sh/
+Install Postgres - Mac: http://postgresapp.com/, Others: https://wiki.postgresql.org/wiki/Detailed_installation_guides
+Install Vagrant - https://docs.vagrantup.com/v2/installation/, using homebrew: http://sourabhbajaj.com/mac-setup/Vagrant/README.html
+Install rvm(ruby-2.1.2 + rails-4.x) - https://rvm.io/rvm/install
+Install Maven -  Mac: brew install maven, Other: http://maven.apache.org/download.cgi
+Install JRuby -  Execute: rvm install jruby
+Install Docker - Mac: https://docs.docker.com/installation/mac/, Ubuntu: https://docs.docker.com/installation/ubuntulinux/
+Install VirtualBox - https://www.virtualbox.org/wiki/Downloads
+Install qt - https://github.com/thoughtbot/capybara-webkit/wiki/Installing-Qt-and-compiling-capybara-webkit
+Install and setup
+Create a local codeOceanRoot:   mkdir /path/to/CodeOcean  
+==> codeOceanRoot = /path/to/CodeOcean 
+Clone Hauke's Repository to codeOceanRoot - https://github.com/openHPI/codeocean (old: https://dev.xikolo.de/gitlab/hklement/xikolo-hands-on-programming, Valid https://dev.xikolo.de/gitlab user required)
+==> repoPath = codeOceanRoot/xikolo-hands-on-programming
+cd repoPath/config
+duplicate .example config files (remove .example from filename)
+action_mailer.yml, database.yml, secrets.yml, sendmail.yml, smtp.yml
+add your local dbuser credentials to database.yml
+Linux users may need to add a "host" and a "port" parameter
+Copy vagrant files from https://github.com/hklement/vagrant-docker to codeOceanRoot
+==> vagrantPath = codeOceanRoot/vagrant-docker-master
+cd vagrantPath
+open Vagrantfile in text editor of choice
+set path for /shared to codeOceanRoot/shared - double check this, when errors like "no target for make run available" arise, this is a likely cause. If in doubt, also check the paths in config/docker.yml match the relative structure)
+Execute: vagrant box add ubuntu/trusty64
+Execute: vagrant up
+Install docker environments
+export DOCKER_HOST=tcp://192.168.23.75:2375
+docker pull hklement/ubuntu-coffee
+docker pull hklement/ubuntu-java
+docker pull hklement/ubuntu-sqlite
+docker pull hklement/ubuntu-sinatra
+docker pull hklement/ubuntu-ruby
+docker pull hklement/ubuntu-python
+docker pull hklement/ubuntu-node
+docker pull hklement/ubuntu-html
+docker pull hklement/ubuntu-jruby
+
+cd repoPath
+bundle install
+ (make sure Postgres is running)
+Create database xikolo-hands-on-programming-development
+Open postgres commandline tool: psql
+mypostgresuser=# create database "xikolo-hands-on-programming-development";   
+rake db:schema:load 
+rake db:migrate
+rake db:seed
+Start
+Start application
+cd vagrantPath
+vagrant up
+cd repoPath
+rails s -p 3333
+Open application in browser
+http://0.0.0.0:3333
+Stop application
+vagrant halt
+
+Run Tests
+Setup:
+Create database xikolo-hands-on-programming-test
+Open postgres commandline tool: psql
+mypostgresuser=# create database "xikolo-hands-on-programming-test"; 
+
+Run:
+Start vagrant
+vagrant up
+cd repoPath
+export DOCKER_HOST=tcp://192.168.23.75:2375
+bundle exec rspec
+
+Login
+admin@example.org:admin