Merge pull request #263 from wunderio/feature/update-doc-for-high-sie…

…rra-workaround

Updated doc to include OS X High Sierra workaround.

troubleshooting.md

@@ -71,3 +71,15 @@ If you have multiple projects and NFS shares in your host machine, check that **
 * #### I'm on linux and I get mount.nfs: requested NFS version or transport protocol is not supported####
 (Linux specific) NFS times out or produces the following error message: `mount.nfs: requested NFS version or transport protocol is not supported`:
 It could be that your OS has updated nfs-utils package to the latest upstream version which by default has UDP protocol support disabled. A quick fix is to edit `/etc/sysconfig/nfs` (Fedora) or `/etc/default/nfs-kernel-server` (Ubuntu) and add `--udp` to `RPCNFSDARGS` and then restart the NFS server.
+
+* #### I'm on OS X High Sierra and build.sh fails with missing files or too many levels of symlinks####
+There's a known issue with using APFS and NFS in High Sierra.  
+A workaround is to have a mounted HFS+ image with your files in it.  
+  - Open Disk Utility
+  - File -> New Image -> Blank Image
+  - Name it whatever, make sure the format is Mac OS Extended (Journaled)
+  - It should then be found at /Volume/{name_of_volume}
+  - Move your site files there
+  - Do a vagrant up in there and enjoy a working environment
+
+It's marginally slower due to having an extra emulation layer due to it being a mounted image, but the only *other* option would be to resize your main partition, and create a new actual real partition with HFS+ for your sites.