diff --git a/MacOS.md b/MacOS.md
index 128a3c0e440..23457877567 100644
--- a/MacOS.md
+++ b/MacOS.md
@@ -1,6 +1,6 @@
-==How to increase maxfiles on MacOS X==
+## How to increase maxfiles on Mac OS X
 
-To increase maxfiles on MacOS create the following file:
+To increase maxfiles on MacOS, create the following file:
 
 (Note: you'll need to use sudo)
 
@@ -29,11 +29,11 @@ To increase maxfiles on MacOS create the following file:
 </plist>
 ```
 
-execute the following command:
+Execute the following command:
 ```
 sudo chown root:wheel /Library/LaunchDaemons/limit.maxfiles.plist
 ```
 
 Reboot.
 
-To check if it's working, you can use 'ulimit -n' command
+To check if it's working, you can use `ulimit -n` command.
diff --git a/doc/build_osx.md b/doc/build_osx.md
index 548d526fd6b..efe423a6934 100644
--- a/doc/build_osx.md
+++ b/doc/build_osx.md
@@ -72,3 +72,7 @@ cmake ..
 make -j $THREADS
 cd ..
 ```
+
+# Caveats
+
+If you intend to run clickhouse-server, make sure to increase system's maxfiles variable. See [MacOS.md](https://github.com/yandex/ClickHouse/blob/master/MacOS.md) for more details.