Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add text on APFS in macOS High Sierra #5451

Merged
merged 4 commits into from
Dec 12, 2017
Merged

Add text on APFS in macOS High Sierra #5451

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
cca244c
Add text on APFS in macOS High Sierra
Dec 6, 2017
8ae4eb5
Remove HFS+ from symlinks
Dec 6, 2017
69d0634
Incorporate feedback
Dec 11, 2017
dd5c3f4
Incorporate feedback, x2
Dec 12, 2017
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 14 additions & 10 deletions docker-for-mac/osxfs.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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

Expand Down