diff --git a/docs/yml.md b/docs/yml.md
index 63b0efbf6..a802909cc 100644
--- a/docs/yml.md
+++ b/docs/yml.md
@@ -75,6 +75,8 @@ expose:
 ### volumes
 
 Mount paths as volumes, optionally specifying a path on the host machine (`HOST:CONTAINER`).
+Note: Mapping local volumes is currently unsuported on boot2docker. We
+recommend you use docker-osx if want to map local volumes.
 
 ```
 volumes: