diff --git a/README.rst b/README.rst
index 73c515a..dc1fd5a 100644
--- a/README.rst
+++ b/README.rst
@@ -18,6 +18,10 @@
 Sample pillars
 ==============
 
+.. caution:: 
+
+    When you use localhost as your database host (keystone:server:database:host), sqlalchemy will try to connect to /var/run/mysql/mysqld.sock, may cause issues if you located your mysql socket elsewhere
+
 Full stacked keystone
 
 .. code-block:: yaml