If I reinstall macOS via Recovery without wiping the disk beforehand, what exactly will be reinstalled, what will be deleted, what will be kept?

2 Answers 2


In the past - Apple had three methods to install:

  • erase and install (now deprecated)
  • archive + install + migrate
  • upgrade install (now deprecated)

Now, when you run the installer - it is always archive, install, migrate. SO the existing system folder isn't touched (it gets archived) and a new system folder and library are created on the drive.

So some folders get erased entirely, some have modification scripts and most user folders don't change. The user folders might get a light script run to clean known issues, but in general - the things in the user home folder are left alone.

The system then reboots into the newly functioning system to run further installations and then kicks off the migration script. That script is responsible for the infamous "about a second" step where it actually goes over each user folder and migrates all the apps, settings and checks for known incompatible software and packages so they can be disabled before any user logs in to the newly made system. The whole process usually takes 5 to 25 minutes for the system tasks and then the last user step can take a few moments or a few hours in my experience. Past an hour, it is usually hung and you might need to do an erase / migration from backup.

The old system is then deleted unless the script detects a potential that it will be needed or the migration failed in some manner.

I you wan to do an erase instal, you need to erase the drive using internet recovery, target disk mode or similar and then run an installer on a blank volume.

  • Thanks. I believe that this answer will be also helpful for future visitors. From what I understand, this means for me that accidentally corrupted files will be repaired, but for example kernel extensions or somehow autostarted processes will not be removed unless they are blacklisted as incompatible.
    – Carsten S
    Oct 31, 2016 at 15:29
  • @CarstenS Yes - that is precisely correct. A new set of binaries and core system files are written - then layers of settings and configurations get applied on top of the clean image. That's the high level overview but it's pretty correct down to the kext layer.
    – bmike
    Oct 31, 2016 at 17:24

Any modifications to the OS or apple applications will be removed. The OS and apple applications will be reinstalled. All your settings, files, 3rd party apps, etc. will be kept. It's just like installing an update.

  • Thanks. While this is very brief, the "just like installing an update" was quite helpful, because I have of course done this lots of times.
    – Carsten S
    Oct 31, 2016 at 15:25

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .