Understanding and Fixing the APFS Container Bug in macOS Disk Utility

When formatting an external device in preparation for macOS High Sierra (or the public beta of Mojave), an odd bug can appear.

Apple’s Craig Federighi introduces APFS, (Apple File System), WWDC 2017.

So you have an external SSD which you want to format as APFS and install, say, macOS High Sierra. However, if you’re planning to install a developer version or public beta of Mojave, read this note by Jeff Gamet.

[macOS Mojave Failing to Install on an External USB Drive? Here’s the Fix ]

The first thing to know is that, when you format the external SSD as APFS, you’ll be creating an APFS container and then the desired volume inside it—which you’ll name. If you’re unsure about APFS containers, see:

[An APFS FAQ: Partitions, Volumes, and AFPS Containers ]

Connect the SSD, very likely with a USB-C to USB-A (or USB-C) connector cable.

You may well see, in the Finder, some developer specific tools and/or encryption tools. Here at TMO we almost always ignore those files because we’re going to totally erase the disk. If encryption is needed, macOS supports it. But I always archive those files first, just in case.

Then launch /Applications/Utilities/Disk Utility.app. Disk Utility may or may not come up in the desired mode. Check out this note by Jeff Gamet.

[How to Format a Drive with GUID for macOS High Sierra, Mojave Installation ]

Basically, the trick is to use the View widget at the top left to select “Show All Devices.”

Now We’re Ready to See an Interesting Bug

1. Select your device. Then, from the tabs at the top select Erase. As the article just above explains, in the drop-down sheet select:  volume name, “APFS” and “GUID Partition Map.” (Note I’m erasing a previously erased device in this example.)

Erase SSD, format as APFS

2. In many cases, and even with a hard disk, you may well see a confusing “ghost” device and a “ghost” volume. They’re dimmed. I’ve outlined them in red below. This is a bug in Disk Utility. (My thanks to Mike Bombich of Bombich Software for confirming. It persists in Mojave early betas.)

The ghost device and volume in red.

3. If you quit Disk Utility and relaunch it, you should see the proper, cleaned up hierarchy: Device > container > volume. (In this example, named “Betelgeuse.”) It should look like this:

All cleaned up. As it should be.

Note that this cleaned up presentation has the same structure as the boot SSD above it. Ghosts are gone. The SSD was ready for a macOS install after the erase, all along, but now there’s no confusion.

This bug has annoyed me for some time now. You may well not see it at all. Hopefully, at some point in the future, Apple will clean this up. Finally, developer Mike Bombich notes that if a quit and relaunch of Disk Utility doesn’t clean up the display of the volumes, a reboot certainly will.

Share this post