1 files changed, 14 insertions, 0 deletions
diff --git a/INSTALL.md b/INSTALL.md
index ea6fbd6ab..899654a25 100644
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -128,8 +128,22 @@ To create `Referential` objects with some data (`Route`, `JourneyPattern`, `Vehi
 
 # Troubleshooting
 
+## Postgres
+
 If Postgres complains about illegal type `hstore` in your tests that is probably because the shared extension is not installed, here is what to do:
 
       bundle exec rake db:test:purge
 
 Thanks to `lib/tasks/extensions.rake`.
+
+## macOS
+
+### Nokogiri
+
+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
+```