diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..3315d4277f549d37a426d00449f125b58ff27564
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+# The Dynare Website
+
+## Pre-requisites
+
+- [Ruby](https://www.ruby-lang.org/en/)
+- [Jekyll](https://jekyllrb.com/)
+
+## Instructions
+
+- clone this repository: `git clone git@git.dynare.org:Dynare/website.git`
+- `cd website`
+- `bundle install`
+- `bundle exec jekyll serve`
+
+## To push version to server
+
+- `JEKYLL_ENV=production bundle exec jekyll serve`
+- push the contents of `_site` folder to server