APFS Disks May Not Be Used As Bootable Install Media

This message means your target drive is APFS; erase it as GUID Partition Map + Mac OS Extended, then run createinstallmedia again.

What The Message Means And Why It Pops Up

You’ll often see this message right after you confirm the erase step in Terminal. The installer tool tries to wipe the destination, lay down boot files, and make a simple startup volume.

If the destination is an APFS container (or an APFS volume inside one), the tool can stop with “apfs disks may not be used as bootable install media” and roll back.

It can feel odd because APFS is the normal format for modern macOS system drives. A bootable installer is different. It’s a small, purpose-built volume meant to start your Mac, load the installer app, and hand off to the real install process.

You’ll see it after formatting a USB as APFS, or when the target sits inside an APFS container.

Most macOS installers still expect the installer USB to begin life as a plain GUID-partitioned device with a single Mac OS Extended (Journaled) volume. The installer can convert the internal target disk to APFS during setup when that’s needed.

What’s failing — The erase and setup of the installer volume, not the macOS installer download.
What fixes it — Erasing the whole device (not just a volume) with the right scheme and format, or letting createinstallmedia do the erase on a compatible volume.
What you keep — Your Mac’s internal drive stays untouched until you boot the installer and choose a destination.

Quick Checks Before You Erase Anything

A rebuild goes smoother when you confirm three things up front: the installer app is complete, the USB is big enough, and you’re pointing the command at the right place.

Check The Installer App Location

The full “Install macOS …” app should sit in your Applications folder. If it lives in Downloads, Desktop, or a subfolder, move it back before you run Terminal commands.

Click the app once and press Command + I to open Get Info. If the size looks tiny, you likely grabbed a small downloader and not the full installer.

Open Applications — Look for “Install macOS Sonoma”, “Install macOS Ventura”, or the version you need.
Confirm It’s Full Size — If the app looks tiny or finishes in seconds, re-download it.

Use A Drive With Enough Space

Most installers fit on 16 GB media. A 32 GB stick cuts the chance of copy failures.

macOS Installer	USB Size	Erase Format
Most recent releases	16–32 GB	Mac OS Extended (Journaled)
Older releases	16 GB	Mac OS Extended (Journaled)
Large USB sticks or SSDs	32+ GB	Mac OS Extended (Journaled)

Confirm The Exact Volume Name

createinstallmedia targets a mounted volume under /Volumes. If the name you type does not match the Finder name, the command can erase the wrong thing or fail to find it.

Plug In The USB — Wait until it appears on the desktop or in Finder.
Rename It Simply — Use a short name like MyUSB with no punctuation.
Recheck In Terminal — Run ls /Volumes and copy the name you see.

APFS Disks May Not Be Used As Bootable Install Media On USB Drives

This section is the fix that resolves the message in most cases. The goal is a clean device map: GUID Partition Map on the device, plus one Mac OS Extended (Journaled) volume for the installer to overwrite.

Erase The Device In Disk Utility

Disk Utility can hide the device layer, so start by showing the full device list. If you erase only an APFS volume, the APFS container can remain and trigger the same failure.

In the sidebar, the device line often ends with the word Media and shows the full capacity. The indented entries under it are volumes. Pick the top device line for a clean slate.

Open Disk Utility — Use Spotlight, type Disk Utility, then press Return.
Show All Devices — In the View menu, pick Show All Devices.
Select The Top Entry — Choose the USB device line, not the indented volume under it.
Click Erase — Set a name you’ll recognize.
Pick The Right Options — Choose Format: Mac OS Extended (Journaled) and Scheme: GUID Partition Map.
Finish And Remount — Click Erase, wait, then confirm the volume mounts in Finder.

Split One Drive Into Two Uses

If you want the same external drive for storage, do it with partitions. Keep one small installer partition in Mac OS Extended, and keep the rest as APFS for files.

Create Two Partitions — In Disk Utility, choose Partition, then add an installer slice first.
Name The Installer Slice — Use a name you can type fast in Terminal.
Leave Storage As APFS — Your file partition can stay APFS without affecting the installer slice.

After this erase step, you should no longer see “apfs disks may not be used as bootable install media” unless the command still points at an APFS volume.

Build The Installer With createinstallmedia

Apple ships createinstallmedia inside each “Install macOS …” app. The command copies the installer files and writes the boot bits so your Mac can start from the USB.

Run The Command Safely

Quit backup apps and disk monitors. Plug the USB straight into the Mac, not through a hub, and check ports.

If your volume name has spaces, either rename it or wrap the path in quotes. A short name avoids mistakes when you’re typing the command under time pressure.

Open Terminal — It’s in Applications > Utilities.
Paste The Path — Type the createinstallmedia path for your installer.
Set The Volume — Use --volume /Volumes/MyUSB with your exact USB name.
Enter Your Password — The cursor won’t move as you type, then press Return.
Confirm The Erase — Type Y when asked.

Command Template You Can Edit

Replace Sonoma with your installer name, and replace MyUSB with your volume name.

sudo /Applications/Install\ macOS\ Sonoma.app/Contents/Resources/createinstallmedia --volume /Volumes/MyUSB

Know What “Erasing Disk” Means Here

The tool erases the target volume you point to. That is expected. If you need files from the USB, copy them off first.

Watch For Progress — You’ll see stages like Erasing Disk and Copying To Disk.
Wait For “Done” — Pulling the drive early is a common reason for a half-built installer.

Start Up From The Installer On Your Mac

Once createinstallmedia finishes, you boot from it using the startup options screen. The startup inputs differ by Mac type.

Mac With Apple Silicon

Shut Down — Power off.
Connect The USB — Plug it directly into the Mac.
Hold The Power Button — Keep holding until startup options appear.
Select The Installer — Pick the installer volume, then click Continue.

Intel Mac

Shut Down — Power off fully.
Connect The USB — Plug it in directly.
Hold Option — Turn on the Mac and hold Option until the boot picker shows.
Select The Installer — Choose the installer, then press Return.

If Your Mac Blocks External Boot

Some Intel Macs with the Apple T2 chip can block external startup until you change a setting in Recovery. If you see a warning about settings, restart into Recovery and adjust the allowed boot media setting.

Enter Recovery — Restart and hold Command + R.
Open Startup Security Utility — Use the Utilities menu in the menu bar.
Allow External Media — Enable booting from external or removable media, then restart and try again.

When It Still Fails: Fixes For Common Errors

If the format is correct and you still hit errors, the cause is often a path typo, a stale mount point, or a USB that drops off the bus mid-write.

If Disk Utility won’t erase, use Terminal with diskutil eraseDisk HFS+ MyUSB GPT /dev/diskX, after checking diskutil list.

“Command Not Found” Or “No Such File Or Directory”

This points to a wrong installer name or a missing installer app. Confirm the installer is in Applications and that the app name matches what you typed, including spaces.

List Installers — In Terminal, run ls /Applications | grep "Install macOS".
Drag The App In — Drag the installer app into Terminal to paste its path.

“The Volume Does Not Appear To Be A Valid Volume”

This usually means the volume name is wrong, the volume is not mounted, or you selected a partition that isn’t the one Finder shows. Replug the USB, confirm it appears under /Volumes, and run the command again.

Remount The Volume — In Disk Utility, select the volume and click Mount if needed.
Use diskutil — Run diskutil list to see the real identifiers and names.

“Resource Busy” Or Copy Stalls

A stuck copy is often a cable, port, or hub issue. Use a different port, avoid adapters when you can, and try another USB stick if the same one fails twice.

Switch Ports — Use a direct port on the Mac.
Try A Fresh Drive — Some budget sticks report space wrong under load.
Keep The Mac Awake — Let the copy finish without sleep.

You Need The Installer For An Older Mac

If you’re building media for an older Mac, match the installer version to what that Mac can run. A 2012 Mac won’t boot a Sonoma installer. Check Apple’s model compatibility list for the macOS release you’re using.

Verify Compatibility — Confirm the target Mac can run that macOS version.
Download The Right Installer — Use Apple’s macOS download links for older releases.

Other Ways To Install macOS When USB Isn’t Needed

A bootable installer is handy for clean installs, lab Macs, and systems that can’t reach Recovery servers. If you only need a reinstall on one Mac, you may not need a USB at all.

Use macOS Recovery Or Internet Recovery

Recovery can reinstall macOS without an external drive. On many Macs, you start it with Command + R at boot, then choose Reinstall macOS from the utilities screen.

Reinstall Over The Top — This keeps user data in place in many cases.
Use Erase First — If you want a clean start, erase the internal disk in Disk Utility inside Recovery.

Use Another Mac To Rebuild The Installer

If your Mac is unstable, you can build the installer on a second Mac and move the USB over. That removes one more variable from the process.

Download On The Healthy Mac — Get the installer app in Applications.
Run createinstallmedia — Build the USB on that Mac, then boot your target Mac from it.

Once you get the format and the command lined up, the fix is repeatable. The next time you see the message, erase the device layer to Mac OS Extended + GUID and rebuild the installer from a fresh download.