diff --git a/docker-for-mac/osxfs.md b/docker-for-mac/osxfs.md index 3926b2e448..8b41853fd7 100644 --- a/docker-for-mac/osxfs.md +++ b/docker-for-mac/osxfs.md @@ -13,16 +13,20 @@ unique capabilities as well as differences from a classical Linux file system. ### Case sensitivity -With Docker for Mac, file systems are shared from macOS into containers in the -same way as they operate in macOS. As a result, if a file system on macOS is -case-insensitive that behavior is shared by any bind mount from macOS into a -container. The default macOS file system is HFS+ and, during installation, it is -installed as case-insensitive by default. To get case-sensitive behavior from -your bind mounts, you must either create and format a ramdisk or external volume -as HFS+ with case-sensitivity or reformat your OS root partition with HFS+ with -case-sensitivity. We do not recommend reformatting your root partition as some -Mac software dubiously relies on case-insensitivity to function. +With Docker for Mac, file systems operate in containers in the same way as they +operate in macOS. If a file system on macOS is case-insensitive, that behavior +is shared by any bind mount from macOS into a container. +On macOS Sierra and lower, the default file system is **HFS+**. On macOS High +Sierra, the default file system is **APFS**. Both are case-insensitive by +default but available in case-sensitive and case-insensitive variants. + +To get case-sensitive behavior, format the volume used in your bind mount as +HFS+ or APFS with case-sensitivity. See the +[APFS FAQ](https://developer.apple.com/library/content/documentation/FileManagement/Conceptual/APFS_Guide/FAQ/FAQ.html). + +Reformatting your root partition is not recommended as some Mac software relies +on case-insensitivity to function. ### Access control @@ -131,7 +135,7 @@ under development. Symlinks are shared unmodified. This may cause issues when symlinks contain paths that rely on the default case-insensitivity of the default macOS file -system, HFS+. +system. ### File types