keepcalculator

06 Numbers and Powers

Troubleshoot a Mac With AppleJack? Fix Guide

Card No. 06·84654 · Updated · Standard formula, shown below

AppleJack is a startup troubleshooting tool that lets you repair permissions, verify disks, and clear caches directly from single-user mode, bypassing a Mac that won’t boot normally. If your Mac is stuck on the Apple logo, kernel panics on startup, or you suspect a corrupted system file, AppleJack can often get you back in without a full reinstall. This guide explains what AppleJack does, how to use it safely, and what to do when it doesn’t solve the problem.

What Is AppleJack and Why Use It?

AppleJack is a free, open-source utility designed for macOS (originally Mac OS X) that automates common maintenance tasks from the command line in single-user mode. Single-user mode is a minimal, text-only environment that loads only the essential parts of the OS, so it can run repairs even when the graphical interface fails. AppleJack runs a series of checks—like verifying the disk, repairing permissions, and cleaning cache files—that can resolve boot issues caused by corrupted system data.

It is not a replacement for Disk Utility or a full backup, but it is a powerful first-aid tool when your Mac won’t start. It works on Intel Macs and older versions of macOS (up to around macOS 10.13 High Sierra); it does not work on Apple Silicon Macs or recent macOS versions that have removed support for the required commands.

How AppleJack Works

AppleJack runs from single-user mode, which you enter by holding Command-S during startup. Once there, you get a root shell with limited tools. AppleJack automates the following tasks, each triggered by a single key press:

  • fsck -fy – checks and repairs the filesystem (like First Aid in Disk Utility).
  • Diskutil repairPermissions – restores correct file permissions on system files (macOS 10.10 and earlier).
  • Clearing cache files – removes system and user caches that might be corrupted.
  • Resetting the swap files – clears virtual memory swap files.
  • Running periodic maintenance scripts – daily, weekly, and monthly scripts that macOS normally schedules.

You start AppleJack by typing applejack at the single-user prompt. It then presents a menu: pressing a runs all checks automatically, or you can choose individual options. It will ask for confirmation before making changes, and you can press Ctrl-C to abort at any time.

Before You Start: Precautions

Running any disk repair carries a small risk of data loss, especially if the disk is already failing. Always back up your important files before attempting repairs, if you can. If your Mac won’t boot at all, you may need to boot from an external drive or use Recovery Mode to back up first.

Also, AppleJack works only on Macs with Intel processors. Apple Silicon Macs (M1, M2, etc.) use a different startup process and do not support single-user mode in the same way. For those, use macOS Recovery (hold the power button) and run Disk Utility’s First Aid instead.

How to Run AppleJack Step by Step

  1. Shut down your Mac completely.
  2. Press the power button, then immediately hold Command-S until you see white text on a black screen.
  3. Wait for the prompt to appear (you’ll see a # or sh-3.2#). You may need to press Return once.
  4. Type applejack and press Return.
  5. If prompted, type your short username and password (AppleJack may ask for an admin user). If it doesn’t ask, it will run as root.
  6. Press a to run all automated checks, or choose a specific option (e.g., f for fsck, p for permissions).
  7. Let it run—it can take 10–30 minutes depending on disk size and age.
  8. When it finishes, type reboot and press Return.

If AppleJack finds and fixes errors, your Mac may boot normally. If it reports errors it cannot fix, you may have a hardware problem or a failing drive.

Common Issues and What to Try If AppleJack Fails

AppleJack is not a magic bullet. If it doesn’t resolve the problem, consider these steps:

  • Boot into Safe Mode (hold Shift during startup) to load only essential extensions and run a directory check.
  • Use macOS Recovery (hold Command-R) and run Disk Utility’s First Aid, which is more modern and supports APFS.
  • Reset NVRAM/PRAM (Intel only) by holding Command-Option-P-R during startup—can fix startup issues.
  • Check if your disk is failing – listen for clicking sounds, check SMART status via Disk Utility or smartctl.
  • Reinstall macOS – if all else fails, reinstall the OS without erasing your data (via Recovery).

AppleJack cannot fix hardware failures, and on newer macOS versions (10.11 and later), permissions repair is no longer needed because the system protects them automatically. On macOS 10.11 El Capitan and later, AppleJack’s permission repair option does nothing useful.

AppleJack vs. Disk Utility vs. fsck

AppleJack is essentially a wrapper around fsck and diskutil, but it runs them in single-user mode, which is more reliable than running them from a booted system. Disk Utility’s First Aid (in Recovery) is the modern equivalent and works on both Intel and Apple Silicon. The main advantage of AppleJack is that it doesn’t require a bootable installer or Recovery partition—it works even if Recovery is damaged. However, it is outdated and not maintained, so for most users, Recovery’s First Aid is the better choice.

Safety and Limitations

AppleJack is safe to use if you follow instructions, but it is not without risk. Running fsck on a disk with hardware errors can worsen data loss. Always back up first. Also, AppleJack is not compatible with FileVault-encrypted disks unless you unlock the disk first (you may be prompted for a passphrase). On modern macOS, single-user mode is disabled by default on Apple Silicon, and even on Intel Macs, AppleJack may not work with APFS (the default filesystem since macOS 10.13). It only works with HFS+ (Mac OS Extended).

Frequently Asked Questions

Does AppleJack work on macOS Big Sur or Monterey?
No. AppleJack has not been updated for macOS 10.15 or later. It may partially work on High Sierra (10.13) with HFS+, but not on APFS volumes. Use Recovery Mode instead.

Is AppleJack safe to use?
Generally yes, but only if you have a backup. It modifies system files, and if interrupted, could cause boot issues. Run it when you have time and power connected.

What if AppleJack says “No errors found” but my Mac still won’t boot?
Try Safe Mode, reset NVRAM, or boot into Recovery and run First Aid. If still failing, the issue may be hardware (RAM, logic board) or a corrupted system file that requires reinstalling macOS.

Can I use AppleJack on a Mac with Apple Silicon (M1/M2)?
No. Apple Silicon Macs do not support single-user mode or AppleJack. Use macOS Recovery by holding the power button.

Do I need to uninstall AppleJack after use?
No, it stays in /usr/local/bin and only runs when you invoke it. It doesn’t affect normal boot.

What is the difference between AppleJack and fsck -fy?
AppleJack runs fsck plus additional tasks like cache clearing and permissions repair. If you only need filesystem repair, you can run fsck -fy manually in single-user mode.

Related

Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.

More cards in this drawer

The whole Numbers and Powers drawer →