APFS
APFS Container Recovery
Scan before repairing or recreating APFS container structures.
Written by the Refindo Recovery Team · Published · Updated
It helps to picture the APFS container as the building and its volumes as theapartments inside. Damage one apartment and the rest are fine; damage the building itself and every apartment is at risk. That is why container-level corruption is more serious than a single bad volume. When the container metadata breaks, volumes vanish or refuse to mount even while the device stays visible. The good news is that volume data blocks live independently of the container header, so files often survive the structure that indexed them.
Quick answer
Container repair and rebuild both overwrite the metadata a scan reads, and neither one preserves the original state. Recover the files first; decide how to fix the container second.
Do not rebuild the container first
- Do not rebuild or recreate the APFS container before you have scanned it.
- Do not repair the container in place, since that overwrites the very records a scan reads.
- Leave the partition map alone while the container is damaged.
- Recover files to a separate drive, not into the affected container.
What damages an APFS container
- Corrupted APFS container superblocks or volume mapping records.
- Partition map changes or failed resizing operations.
- Power loss during writes or system updates.
- SSD behavior, including TRIM, reducing recovery after deletion.
How to scan a damaged APFS container
Refindo is suitable for scan-and-preview recovery from a detectable APFS device. It doesn't rebuild APFS containers in place.
- Connect the APFS disk to a supported Mac and grant Refindo disk access.
- Open Refindo and select the physical device holding the damaged container.
- Run Quick Scan, then Deep Scan to find volumes through alternate superblock copies.
- Preview the files you need and recover them to a separate drive.
When the container shows no volumes
- Disk Utility shows the container with no mountable volumes or zero-byte volumes.
- The container holds the only copy of irreplaceable data.
- The disk reports hardware errors or disconnects during scanning.
- Recent deletion occurred on an SSD where TRIM may have cleared blocks.
APFS superblocks and surviving volumes
APFS Superblock Structure
Each APFS container uses a superblock that stores the container layout, volume count, and checkpoint data. The superblock is written to multiple locations for redundancy. If the primary superblock is corrupted, recovery tools may locate an older checkpoint copy and use it to map surviving volumes and their file trees.
Do Volumes Survive Container Damage?
Volume data blocks are stored independently of the container superblock. If the container metadata is damaged but the underlying storage is intact, individual file data may still be recoverable through signature-based scanning. The volume records are lost, but the raw file content often persists on the device.
Container Recovery vs Rebuild
Repairing a container modifies its metadata in place, which risks overwriting the very records a scan needs. Rebuilding creates an entirely new container, erasing old metadata completely. Neither approach preserves the original state, so scanning before either operation gives the best chance of recovering files.
Frequently Asked Questions
What is an APFS container?
It's the APFS structure that stores and manages APFS volumes on a disk or partition.
Can I repair the container first?
If files matter, recover first. Repair attempts can change the structures a scan would otherwise inspect.
Can Refindo recover folder names?
Folder names depend on remaining metadata. Deep Scan can find file content even when folder structure is incomplete.
How do I know if my APFS container is damaged?
Disk Utility may show the container with no mountable volumes, or diskutil list may display the container with zero-byte volumes or error annotations.
Can a damaged APFS container affect my other partitions?
No. Container damage is limited to the APFS partition. Other partitions on the same physical disk, such as an EFI or bootcamp partition, aren't affected.
Scan before you repair
Run a read-only scan first, preview what is recoverable, then save selected files to a different drive.