How to Reset APFS Disk Volume UUID on macOS

Abstract: Resets APFS volume UUID by erasing and recreating the volume to resolve mounting errors or orphaned drive issues.

Created: 2026-08-05 by

You cannot directly reset or change the UUID of an existing APFS volume because the Universally Unique Identifier is generated automatically during creation and is immutable by design. To obtain a new UUID, you must back up your data, erase the volume to create a fresh file system structure, and then restore your files onto the newly created volume.

Understanding APFS Volume Identifiers

The UUID serves as a unique fingerprint for every disk volume in macOS. It ensures that the operating system can distinguish between multiple partitions, even if they have identical names. This identifier is critical for system processes such as mounting volumes, managing Time Machine backups, and enforcing security permissions. Unlike file names, which users can change freely, the UUID is baked into the volume's metadata at the moment of creation. Attempting to modify this value through standard utilities like Disk Utility will fail because Apple’s file system architecture does not expose a command-line flag or GUI option for altering it. This immutability prevents conflicts that could arise from duplicate identifiers on the same network or storage array. If you are encountering issues where macOS fails to recognize a drive or mount points are behaving erratically, the problem might stem from corrupted metadata rather than the UUID itself. However, in cases where a volume has become orphaned or requires a clean slate for troubleshooting, generating a new identifier via recreation is the only viable path. For more information on resolving general directory issues, you might find Directory Not Accepting File or Folder with Certain Name: A Guide for iMac Users helpful, as some copy errors can mimic volume recognition failures.

Preparation and Data Safety

Before proceeding with any structural changes to your storage, you must ensure that all critical data is safely preserved. The process of erasing a volume permanently deletes all contents. Therefore, creating a complete backup is non-negotiable. You should use Time Machine to create a full system backup to an external drive. Alternatively, manually copy important documents, photos, and application support folders to a separate storage device. Verify the integrity of your backup before starting. Open Finder and navigate to your backup location to ensure files are accessible. If you are using an external drive formatted as NTFS, remember that macOS can read but not write to NTFS by default. In such scenarios, you may need to Format an NTFS Drive to APFS on Windows or use third-party software to enable write access, ensuring your backup medium is compatible with macOS operations.

Step-by-Step Procedure to Recreate the Volume

Follow these steps to effectively reset the UUID by recreating the volume. This method works for both internal startup drives and external data volumes.
  1. Open Disk Utility: Navigate to Applications > Utilities > Disk Utility. You can also search for it using Spotlight (Command + Space).
  2. Select the Target Volume: In the sidebar, click on the specific APFS volume whose UUID you wish to change. Ensure you select the volume, not just the container.
  3. Erase the Volume: Click the "Erase" button in the toolbar. A dialog box will appear.
  4. Configure Settings: Enter a new name for the volume. For Format, select "APFS." For Scheme, choose "GUID Partition Map" if you are dealing with a physical disk, or leave it blank if formatting a logical volume within an APFS container.
  5. Confirm Erasure: Click "Erase" again to confirm. Disk Utility will wipe the volume and generate a brand new UUID. This process may take several minutes depending on the size of the drive.
Once the erase operation completes, the volume will appear in Finder with its new identity. Your previous data is still on the backup medium. Now, you can drag and drop your files back onto the freshly formatted volume. This restores functionality while ensuring the underlying identifier is completely distinct from the original.

Verifying the New UUID

After restoring your data, verify that the volume has indeed received a new identifier. Open Terminal and run the following command:
diskutil info /Volumes/YourNewVolumeName | grep "Volume UUID"
Replace "YourNewVolumeName" with the actual name you assigned during the erase step. The output will display the new 32-character hexadecimal string. Compare this with the old UUID if you recorded it previously. They should be entirely different. If the system reports an error or fails to mount the volume, check the console logs for I/O errors, which might indicate hardware issues rather than software configuration problems.

Common Pitfalls and Troubleshooting

Sometimes, users attempt to use third-party tools claiming to modify UUIDs. These tools often interact with low-level filesystem structures and can cause severe corruption. It is strongly advised against using such utilities. Instead, rely on Apple’s native Disk Utility, which handles the necessary metadata updates safely. If you are unable to erase the volume because it is in use by the system, you must boot from a recovery partition or an external installer. Restart your Mac while holding Command + R to enter Recovery Mode. From there, open Disk Utility and perform the erase operation on the main drive. This bypasses the active system locks that prevent modification of the startup volume.

Frequently Asked Questions

Can I change the UUID without losing data?

No, it is technically impossible to change the UUID of an APFS volume without erasing it. The identifier is embedded in the volume header, and modifying it would require rewriting the entire filesystem structure. Always back up your data first.

Why does my Mac not recognize the external drive after erasing?

This usually happens if the volume was erased with an incompatible scheme or format. Ensure you selected "APFS" for the format and "GUID Partition Map" for the scheme when erasing. Re-check the connection cable and try a different USB port.

Is it safe to erase my startup disk to get a new UUID?

It is safe provided you have a valid backup. However, erasing the startup disk removes macOS itself. You will need to reinstall macOS from Recovery Mode after the erase. Ensure you have an internet connection or a macOS installer available.

Does resetting the UUID fix slow drive performance?

No, changing the UUID has no impact on read/write speeds or overall performance. Slowdowns are typically caused by fragmentation, failing hardware, or excessive background processes. Focus on disk health diagnostics instead.

How do I know if my volume UUID is corrupted?

Corruption is usually indicated by mount failures, kernel panics, or errors in the Console app. If the drive appears grayed out in Disk Utility or shows "Invalid," it may need repair using First Aid before considering recreation.

Latest News

How to Display Output of xterm Command in Terminal Screen using Cron

Resolve the inability to display xterm output in a terminal screen from cron by redirecting logs or using wall instead of insecure X11 workarounds.

Read More
Expose Local Server on VPS Preserving Real Client IPs (OS Level)

Resolve VPS logging showing only gateway IPs by configuring reverse proxies to forward real client addresses via X-Forwarded-For headers.

Read More
How to Clear Recent Files History in Linux without Deleting Actual Files?

Clear recent files history in Linux by deleting ~/.local/share/recently-used.xbel without removing the actual files.

Read More
Best HDD Copy Strategy: Manually Syncing and Rewriting Scratch

Resolve data drift between two 4TB hard drives by using rsync with the --delete flag to manually sync and rewrite scratch data for an exact mirror.

Read More
Understanding Bash Prompt Abbreviations: An Overview

Resolve repetitive typing errors by creating and persisting Bash aliases in the .bashrc file for improved command-line efficiency.

Read More
Free Tools and Methods to Log Real-Time Performance Details in Task Manager

Log real-time CPU and memory metrics to CSV files using Windows Performance Monitor Data Collector Sets to troubleshoot system slowness.

Read More
Contact Qatar Airways Customer Service: Phone Number, Help Center, and More

Resolve urgent Qatar Airways reservation issues like flight changes and baggage claims using the US phone number +1801-855-5905 or online self-service tools.

Read More
Windows 11: Alt Codes Displaying Wrong Characters - Solutions

Resolve Windows 11 Alt codes showing wrong characters by verifying the US keyboard layout and enabling Num Lock.

Read More
Run Programs with Elevated Privileges: A Comprehensive Guide

Eliminates the need to type sudo for frequent administrative tasks by configuring .bashrc aliases or functions.

Read More
Dynamically Changing Dates in Excel Formulas Using Cells

Eliminate manual date updates in Excel by using cell references to create dynamic formulas that automatically adjust calculations when input dates change.

Read More
Granting Edit Access to a Specific Excel Sheet in an Office 365 User Email ID-Based Login

Excel Online lacks native sheet-level permissions, so users must split workbooks or use worksheet protection to isolate edit access for specific tabs.

Read More
Creating Network Load on Local Wi-Fi from One PC

Generate sustained Wi-Fi bandwidth load from a single PC using a VM SFTP server to test router stability and throughput.

Read More
Changing the Default Editor for Batch Files in Windows 11's File Explorer

Resolve the issue of batch files opening in Notepad by changing the default editor to a preferred application like VS Code.

Read More
Gain WiFi Connection Minutes Before Losing it by Changing MAC Address

Bypass MAC address filtering to restore WiFi connectivity temporarily when a device is blocked by network administrators.

Read More
Photos Folders Turned Black: Troubleshooting Picture Applications on Windows

Resolve black screens in Windows Photos by resetting the app, updating graphics drivers, and repairing system files.

Read More
Troubleshooting High CPU Temperature Values: A Step-by-Step Guide

Resolve high CPU temperatures and thermal throttling by monitoring with Speedfan, cleaning dust from cooling components, and replacing degraded thermal paste.

Read More
Make cURL establish TLS connection with CA unknown

Resolve cURL TLS connection failures with unknown or self-signed certificates by using the --insecure flag to bypass CA validation.

Read More
Troubleshooting Incorrect Network Metrics Values in Grafana, Prometheus, InfluxDB, and Telegraf

Fix incorrect network metrics in Grafana, Prometheus, InfluxDB, and Telegraf by verifying interface selection, resolving unit mismatches, and handling counter resets.

Read More
Start Another Terminal Window (cmd.exe) Windows Repair/Troubleshoot

Provides step-by-step instructions to access the Windows Command Prompt via bootable media for advanced system repair and troubleshooting.

Read More
Thinkpad P1 Gen 6: Sudden Thunderbolt 3 Dock USB-C Charging Stopped Working

Resolve sudden Thunderbolt 3 dock USB-C charging and internet failure on ThinkPad P1 Gen 6 by updating firmware, resetting the dock, and adjusting power settings.

Read More
ASUS Windows 11 Laptop: Internet Connection Issue with Hotspot

Resolve ASUS Windows 11 laptop spinning wheel issue when connecting to mobile hotspot by resetting network stack, disabling IPv6, and adjusting power settings.

Read More
Developing iOS Project with Firebase: Logging in and Sending Push Notifications

Integrates Firebase to enable secure user authentication and push notifications in iOS applications.

Read More
Troubleshooting Bash Script with Suspected Issues of Spaces, Dashes, Filenames and Quoting

Resolve Bash script failures caused by word splitting, globbing, and special characters in filenames by applying proper quoting techniques.

Read More
Populating OneDrive Folder for Local Backup without Affecting Remote Files

Prevent OneDrive from deleting remote files during Windows reinstallation by unlinking the account or using symbolic links to isolate local data.

Read More
Force First Frame as Keyframe Without Re-encoding: A Quick Solution

Resolve inaccurate seeking and playback glitches by re-encoding video to ensure the first frame is a valid keyframe.

Read More
Find Information in Database Using WSL (Ubuntu) on Windows-10

Resolve database connection issues from WSL Ubuntu on Windows 10 by configuring client tools and network access to query remote or local servers.

Read More
Configuring a New Router with Different Networks: One Family, One Guest

Resolve IP conflicts and isolate guest traffic by configuring a second router with a distinct subnet via its WAN port.

Read More
Quickly Open Multiple Stock Websites with a Single Command

Solve the problem of manually opening multiple stock research websites by creating a single command to launch them simultaneously on Windows, macOS, or Linux.

Read More
Improved Adobe Acrobat Search Experience: Access Advanced Search with Ease

Access advanced search filters like case sensitivity and regex in Adobe Acrobat by clicking More Options in the Find bar.

Read More
Port Forwarding VM via OpenVPN: A Comprehensive Guide

Configure OpenVPN server and iptables to forward specific ports from VPN clients to a virtual machine's internal IP address.

Read More
Understanding Partitions in the 1980s: A Look Back at MS-DOS and Master Boot Record

Explains how the Master Boot Record and partition table enabled MS-DOS to manage multiple disk volumes on a single physical drive.

Read More
Windows 10 Enterprise: Keyboard Not Detected in Managed Organization with Admin Privileges

Resolve Windows 10 Enterprise keyboard detection failures caused by Group Policy restrictions, driver corruption, or USB enumeration errors.

Read More
Can't Find x86_64 Versions of Applications on MacOS arm64 (M1)

Resolve missing x86_64 app issues on M1 Macs by installing Rosetta 2 and reinstalling apps as universal binaries.

Read More
How to Hide Installation Source for an Android App

Manage Android app installation source visibility by using USB transfers or file managers to reduce browser traces and isolate data via work profiles.

Read More
Connecting Momentus 4200.2 ST9808210A Hard Drive via USB Cable

Resolve inability to access Seagate Momentus 4200.2 ST9808210A hard drive by connecting it via USB using a compatible SATA-to-USB adapter and configuring the disk in Windows.

Read More