diff --git a/README.md b/README.md
index f1fd88f..7a7d227 100644
--- a/README.md
+++ b/README.md
@@ -101,3 +101,11 @@ Starting with 0.2.0, the in-place reload can be done with an ad-hoc function:
 ```sql
 SELECT cartodb.cdb_extension_reload();
 ```
+
+Troubleshooting
+---------------
+### Mac OS X sed
+Mac OS X comes with sed from FreeBSD, some scripting in Makefile is incompatible with that version of sed so we recommend you to install GNU sed. The easiest way is via [Homebrew](http://brew.sh/) like in:
+```sh
+brew install gnu-sed --default-names
+```