diff --git a/README.md b/README.md
index 76e05a7..98bedb0 100644
--- a/README.md
+++ b/README.md
@@ -92,6 +92,12 @@ To install from the git repo:
     cd lua-resty-aws
     make install
 
+### Troubleshooting
+
+MacOS has a known issue that the libexpat header file 'expat_config.h' is missing. If you run into that issue, install libexpat manually (eg. `brew install libexpat`). And then include the libexpat location when installing;
+        luarocks install lua-resty-aws EXPAT_DIR=/path/to/expat
+
+Details: https://github.com/lunarmodules/luaexpat/issues/32
 ---
 
 ## Development