Publishers of technology books, eBooks, and videos for creative people

Home > Articles > Apple > Operating Systems

From the book Reference 29.5

Reference 29.5
System Initialization Troubleshooting

Once you can identify the various stages—and know which processes and files are responsible for each, you are well on your way to diagnosing any startup issue. Case in point, the troubleshooting sections outlined here are organized by each stage of the system initialization process.

Also, throughout the remainder of this section, you will learn how each of the three primary OS X diagnostic startup modes—verbose mode, safe mode, and single-user mode—help resolve or identify issues. These three modes are initiated at the firmware stage but affect the remaining system initialization process at each stage. The ramifications of each diagnostic startup mode are covered with each stage throughout this section.

Troubleshooting the Firmware

Issues at the firmware stage are indicated by the inability of your Mac to reach the light gray screen with the dark gray Apple icon. The key to troubleshooting at this point is to determine whether this issue is related to the Mac computer’s hardware or system volume.

Serious Hardware Issues

If you don’t hear the startup chime or see the power-on light flash, the Mac hardware did not pass the POST. You may also hear a series of diagnostic tones or see a series of power-on flashes. If this is the case, your Mac has a fundamental hardware issue.

You can always check for simple things first. Is the Mac plugged into an electrical outlet? Are the keyboard and mouse working properly? Ultimately, a failure to pass the POST is usually indicative of a serious hardware issue. If this is the case, you’ll be best served by taking your Mac to an Apple Store or Apple Authorized Service Provider.

System Volume Issues

If your Mac passes the POST, but you are left with a flashing dark gray question mark folder icon, it means the firmware cannot locate a valid system volume or booter file. The Mac computer’s main processor and components are probably working correctly, and you may only have a software issue. Hold down the Option key during startup and use the Startup Manager to locate system volumes.

To troubleshoot system volume issues:

  • If the original system volume appears, select it to start up from it. If your Mac starts up from the system on the volume, open Startup Disk preferences to reset the volume as the startup disk. You can also attempt to define the startup disk when booted from another system volume like an external OS X Recovery disk, as covered in Lesson 4, “OS X Recovery.”
  • If the original system volume appears, but your Mac still cannot find a valid system or booter, you may need to reinstall OS X on that volume. As always, back up any important data from that volume before you make significant changes.
  • If your original system volume does not appear, the issue lies with that storage device. Start up from another system, like an external OS X Recovery disk, and use the storage troubleshooting techniques outlined in Lesson 13, “File System Troubleshooting.”

Troubleshooting the Booter

Issues at the booter stage are indicated by a flashing dark gray prohibitory icon—evidence of a failure to load the kernel.

To troubleshoot the booter:

  • If you’re starting up the Mac from a volume containing a system this Mac has never booted from, the prohibitory icon usually indicates that the version of OS X on the volume is not compatible with your Mac computer’s hardware. This is an extremely rare case that occurs mainly when a new Mac is restored using an older system image. The solution as this point is to reinstall OS X, using OS X Recovery, to a version of OS X that is known to work with this specific hardware.
  • Start up the Mac while holding down the Shift key to initiate a Safe Boot. The booter first attempts to verify and repair the startup volume, indicated by a dark gray progress bar across the bottom of the main display. If repairs are necessary, the Mac automatically restarts before continuing. If this happens, continue to hold down the Shift key. The booter verifies the startup volume again, and if the volume appears to be working properly, the booter attempts to load the kernel and essential KEXTs again. The booter uses the most judicial, and slowest, process to load these items and clears both the KEXT and font caches. If successful, the booter passes off the system to the kernel, which continues to safe-boot.
  • If the booter cannot find or load a valid kernel, you may need to reinstall OS X on that volume.

Troubleshooting the Kernel

Issues at the kernel stage are indicated by an inability to reach the login window or automatic login process, as evidence of a failure to load all KEXTs, the core UNIX system, and ultimately the system launchd process. If this is the case, your Mac is stuck at the light gray screen with the dark gray spinning gear icon. In these cases, the spinning gear progress indicator may stay visible indefinitely, again signaling a failure to complete the startup process.

To troubleshoot the kernel:

  • Start up the Mac while holding down the Shift key to initiate a Safe Boot. In addition to the Safe Boot procedures covered in the “Troubleshooting the Booter” section earlier, this forces the kernel to ignore all third-party KEXTs. If successful, the kernel starts the system launchd process, which continues to safe-boot. Completing the kernel startup stage via a Safe Boot indicates the issue may be a third-party KEXT, and you should start up in verbose mode to try to identify the problematic KEXT.
  • Start up the Mac while holding down Command-V to initiate verbose mode. The Mac shows you the startup process details as a continuous string of text. If the text stops, the startup process has probably also stopped, and you should examine the end of the text for troubleshooting clues. When you find a suspicious item, move it to a quarantine folder and then restart the Mac without Safe Boot, to see if the problem was resolved. This may be easier said than done, as accessing the Mac computer’s disk to locate and remove the item may not be possible if the Mac is crashing during startup. This is an example of where target disk mode really shines. As covered in Lesson 13, “File System Troubleshooting,” you can easily modify the contents of a problematic Mac system volume using target disk mode and a second Mac.
  • If the kernel cannot completely load while safe-booting or you are unable to locate and repair the problematic items, you may need to reinstall OS X on that volume.

Troubleshooting the System launchd

Issues at this stage are indicated by an inability to reach the login screen or log in a user (evidence of a failure by the system launchd process). If the system launchd process is not able to complete the system initialization, the loginwindow process does not start. Your Mac will be stuck with either a black screen or a white screen, depending on how far the system launchd got.

To troubleshoot system launchd issues:

  • Start up the Mac while holding down the Shift key to initiate a Safe Boot. In addition to the Safe Boot procedures covered earlier in the “Troubleshooting the Booter” and “Troubleshooting the Kernel” sections of this lesson, this forces the system launchd process to ignore all third-party fonts, launch daemons, and startup items. If successful, the system launchd process starts the loginwindow. At this point the Mac system has fully started up and is now running in safe mode. Completing the system initialization process via Safe Boot indicates the issue may be a third-party system initialization item, and you should start up in verbose mode to try to identify the problematic item.
  • Start up the Mac while holding down Command-V to initiate verbose mode. Again, if the text stops scrolling down the screen, examine the end of the text for troubleshooting clues; if you find a suspicious item, move it to another folder and then restart the Mac normally.
  • At this point you may be able to successfully Safe Boot into the Finder. If so, use the Finder interface to quarantine suspicious items.
  • While working in safe mode, you may also consider removing or renaming system cache and preference files, as they can be corrupted and cause startup issues. Begin by removing /Library/Caches because those files contain easily replaced information. As far as system preferences go, you can remove any setting stored in the /Library/Preferences or /Library/Preferences/SystemConfiguration folders you’re comfortable with having to reconfigure. A much safer solution is to simply rename individual system preference files in these folders. Once you have moved or replaced these items, restart the Mac, and the system automatically replaces these items with clean versions.
  • If Safe Boot continues to fail or you have located a suspicious system item you need to remove, start up the Mac while holding Command-S to initiate single-user mode. You’ll see a minimal command-line interface that allows you to move suspicious files to a quarantine folder. If you want to modify files and folders in single-user mode, you have to prepare the system volume. Start by entering /sbin/fsck -fy to verify and repair the startup volume. Repeat this command until you see a message stating that the disk appears to be OK. Only then should you enter /sbin/mount -uw / to mount the startup volume as a read-and-write file system. Once you have made your changes, you can exit single-user mode and continue to start up the system by entering the exit command, or you can shut down the Mac by entering the shutdown -h now command.
  • If the system initialization process cannot complete while safe-booting or you are unable to locate and repair the problematic items, you may need to reinstall OS X on that volume.

Peachpit Promotional Mailings & Special Offers

I would like to receive exclusive offers and hear about products from Peachpit and its family of brands. I can unsubscribe at any time.


Pearson Education, Inc., 221 River Street, Hoboken, New Jersey 07030, (Pearson) presents this site to provide information about Peachpit products and services that can be purchased through this site.

This privacy notice provides an overview of our commitment to privacy and describes how we collect, protect, use and share personal information collected through this site. Please note that other Pearson websites and online products and services have their own separate privacy policies.

Collection and Use of Information

To conduct business and deliver products and services, Pearson collects and uses personal information in several ways in connection with this site, including:

Questions and Inquiries

For inquiries and questions, we collect the inquiry or question, together with name, contact details (email address, phone number and mailing address) and any other additional information voluntarily submitted to us through a Contact Us form or an email. We use this information to address the inquiry and respond to the question.

Online Store

For orders and purchases placed through our online store on this site, we collect order details, name, institution name and address (if applicable), email address, phone number, shipping and billing addresses, credit/debit card information, shipping options and any instructions. We use this information to complete transactions, fulfill orders, communicate with individuals placing orders or visiting the online store, and for related purposes.


Pearson may offer opportunities to provide feedback or participate in surveys, including surveys evaluating Pearson products, services or sites. Participation is voluntary. Pearson collects information requested in the survey questions and uses the information to evaluate, support, maintain and improve products, services or sites; develop new products and services; conduct educational research; and for other purposes specified in the survey.

Contests and Drawings

Occasionally, we may sponsor a contest or drawing. Participation is optional. Pearson collects name, contact information and other information specified on the entry form for the contest or drawing to conduct the contest or drawing. Pearson may collect additional personal information from the winners of a contest or drawing in order to award the prize and for tax reporting purposes, as required by law.


If you have elected to receive email newsletters or promotional mailings and special offers but want to unsubscribe, simply email

Service Announcements

On rare occasions it is necessary to send out a strictly service related announcement. For instance, if our service is temporarily suspended for maintenance we might send users an email. Generally, users may not opt-out of these communications, though they can deactivate their account information. However, these communications are not promotional in nature.

Customer Service

We communicate with users on a regular basis to provide requested services and in regard to issues relating to their account we reply via email or phone in accordance with the users' wishes when a user submits their information through our Contact Us form.

Other Collection and Use of Information

Application and System Logs

Pearson automatically collects log data to help ensure the delivery, availability and security of this site. Log data may include technical information about how a user or visitor connected to this site, such as browser type, type of computer/device, operating system, internet service provider and IP address. We use this information for support purposes and to monitor the health of the site, identify problems, improve service, detect unauthorized access and fraudulent activity, prevent and respond to security incidents and appropriately scale computing resources.

Web Analytics

Pearson may use third party web trend analytical services, including Google Analytics, to collect visitor information, such as IP addresses, browser types, referring pages, pages visited and time spent on a particular site. While these analytical services collect and report information on an anonymous basis, they may use cookies to gather web trend information. The information gathered may enable Pearson (but not the third party web trend services) to link information with application and system log data. Pearson uses this information for system administration and to identify problems, improve service, detect unauthorized access and fraudulent activity, prevent and respond to security incidents, appropriately scale computing resources and otherwise support and deliver this site and its services.

Cookies and Related Technologies

This site uses cookies and similar technologies to personalize content, measure traffic patterns, control security, track use and access of information on this site, and provide interest-based messages and advertising. Users can manage and block the use of cookies through their browser. Disabling or blocking certain cookies may limit the functionality of this site.

Do Not Track

This site currently does not respond to Do Not Track signals.


Pearson uses appropriate physical, administrative and technical security measures to protect personal information from unauthorized access, use and disclosure.


This site is not directed to children under the age of 13.


Pearson may send or direct marketing communications to users, provided that

  • Pearson will not use personal information collected or processed as a K-12 school service provider for the purpose of directed or targeted advertising.
  • Such marketing is consistent with applicable law and Pearson's legal obligations.
  • Pearson will not knowingly direct or send marketing communications to an individual who has expressed a preference not to receive marketing.
  • Where required by applicable law, express or implied consent to marketing exists and has not been withdrawn.

Pearson may provide personal information to a third party service provider on a restricted basis to provide marketing solely on behalf of Pearson or an affiliate or customer for whom Pearson is a service provider. Marketing preferences may be changed at any time.

Correcting/Updating Personal Information

If a user's personally identifiable information changes (such as your postal address or email address), we provide a way to correct or update that user's personal data provided to us. This can be done on the Account page. If a user no longer desires our service and desires to delete his or her account, please contact us at and we will process the deletion of a user's account.


Users can always make an informed choice as to whether they should proceed with certain services offered by Adobe Press. If you choose to remove yourself from our mailing list(s) simply visit the following page and uncheck any communication you no longer want to receive:

Sale of Personal Information

Pearson does not rent or sell personal information in exchange for any payment of money.

While Pearson does not sell personal information, as defined in Nevada law, Nevada residents may email a request for no sale of their personal information to

Supplemental Privacy Statement for California Residents

California residents should read our Supplemental privacy statement for California residents in conjunction with this Privacy Notice. The Supplemental privacy statement for California residents explains Pearson's commitment to comply with California law and applies to personal information of California residents collected in connection with this site and the Services.

Sharing and Disclosure

Pearson may disclose personal information, as follows:

  • As required by law.
  • With the consent of the individual (or their parent, if the individual is a minor)
  • In response to a subpoena, court order or legal process, to the extent permitted or required by law
  • To protect the security and safety of individuals, data, assets and systems, consistent with applicable law
  • In connection the sale, joint venture or other transfer of some or all of its company or assets, subject to the provisions of this Privacy Notice
  • To investigate or address actual or suspected fraud or other illegal activities
  • To exercise its legal rights, including enforcement of the Terms of Use for this site or another contract
  • To affiliated Pearson companies and other companies and organizations who perform work for Pearson and are obligated to protect the privacy of personal information consistent with this Privacy Notice
  • To a school, organization, company or government agency, where Pearson collects or processes the personal information in a school setting or on behalf of such organization, company or government agency.


This web site contains links to other sites. Please be aware that we are not responsible for the privacy practices of such other sites. We encourage our users to be aware when they leave our site and to read the privacy statements of each and every web site that collects Personal Information. This privacy statement applies solely to information collected by this web site.

Requests and Contact

Please contact us about this Privacy Notice or if you have any requests or questions relating to the privacy of your personal information.

Changes to this Privacy Notice

We may revise this Privacy Notice through an updated posting. We will identify the effective date of the revision in the posting. Often, updates are made to provide greater clarity or to comply with changes in regulatory requirements. If the updates involve material changes to the collection, protection, use or disclosure of Personal Information, Pearson will provide notice of the change through a conspicuous notice on this site or other appropriate way. Continued use of the site after the effective date of a posted revision evidences acceptance. Please contact us if you have questions or concerns about the Privacy Notice or any objection to any revisions.

Last Update: November 17, 2020