Skip to content

macOS Source Code Volume

Create a case-sensitive APFS volume at /Volumes/src for source code. macOS defaults to case-insensitive, causing issues with Linux and git.

Setup

Create a dedicated case-sensitive APFS volume at /Volumes/src for all source code.

Setup Steps

  1. Open Applications > Utilities > Disk Utility
  2. Select your main internal drive (top-level disk)
  3. Click + to add a new APFS volume
  4. Set Name to: src
  5. Set Format to: APFS (Case-sensitive)
  6. Click Add

The volume mounts automatically at /Volumes/src and persists across reboots.

sh
ln -s /Volumes/src ~/src

Now cd src from home reaches the volume.

Enable Spotlight Indexing

sh
sudo mdutil -i on /Volumes/src

Verify Installation

sh
diskutil info /Volumes/src | grep "File System Personality"

Expected: File System Personality: Case-sensitive APFS

Wrong: File System Personality: APFS (case-insensitive)