Skip to content
APFS & Docker: Accented Latin and Japanese Kana Compatibility PoC
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

APFS Japanese Kana Compatibility PoC

Read more on this detailed post: Accented Latin and Kana File Names Finally Work as Expected in APFS

Problem of Kana File Name

In HFS+, file name will be decomposed to Unicode NFD form. So a file named ありがとう will be decomposed to ありか<U+3099>とう, where U+3099 is a 濁点 sound mark.

When we build an image that is based on Linux, Docker doesn't compose the string back to NFC form, thus any file with 濁点 or 半濁点 will not be accessible.

For example:

$ docker build -t test-image .
$ docker run test-image cat ありがとう.txt
cat: can't open '/ありがとう.txt': No such file or directory

Becuase the file name is in NFD form, it can only be accessed by ありか<U+3099>とう.txt.

APFS has no such problem

In APFS, file names are not decomposed to NFD form, thus there is no such problem.

To try it, first upgrade to macOS 10.12.4+.

Create a disk:

hdiutil create -fs APFS -size 1GB foo.sparseimage

Mount it, and cd to it in the terminal.

Now try again:

$ docker build -t test-image .
$ docker run test-image ありがとう.txt
ありがとう means Thank You!

It works


Public Domain

You can’t perform that action at this time.