MacOS – How to Remove or Edit a synthetic.conf File in etc/

macos

I have a Mac in which the user has placed a synthetic.conf file in etc/
The file contains an entry for home creating a synthetic link to some directory. This makes it unbootable. Normally the computer is running Catalina. I can boot it using a Mojave startup that was still on the drive. I have admin privileges.

I would like to delete or edit that file. I can't even find it. This problem is beyond me.

Best Answer

To edit or remove synthetic.conf when it is causing catalina not to boot or login to your user, you must first boot into Recovery mode (hold down CMD+R during he boot sound). Then from the Utilities menu open the Terminal.

If you have FileVault enabled you will need to unlock the boot drive (there are other questions with answers on how to do this from the terminal so I wont repeat those here).

Provided that you have unlocked the boot drive you should be able to use the ‘find’ utility to locate your synthetic.conf like this:

cd /
find / -name synthetic.conf

For me it was inside a ‘private’ folder.

Then you can delete it with ‘rm’ or edit it with ‘vi’ if you’re feeling brave; I just deleted mine. Turns out that if you put spaces in it, instead of tabs, it causes your system not to boot on Catalina - What a great feature Apple :-)