Chapter 1: Getting Started

Chapter 2: Using Atom

Chapter 3: Hacking Atom

Chapter 4: Behind Atom

Reference: API

Appendix A: Resources

Appendix B: FAQ

Appendix C: Shadow DOM

Appendix D: Upgrading to 1.0 APIs

Appendix E: Atom server-side APIs

Improve this page

I am unable to update to the latest version of Atom on macOS. How do I fix this?

Atom shows there is a new version available but the version fails to install. You might have an error message showing a permissions error for example:

Updating Atom on macOS

or it will say downloading but forever loops without restarting or updating.

You need to fix one or more of the following directories:

  • /Applications/Atom.app/
  • ~/Library/Caches/com.github.atom.ShipIt
  • ~/Library/Application Support/com.github.atom.ShipIt

Do the following:

  1. Completely exit Atom
  2. Open a terminal
  3. Execute: whoami
  4. Write down the result of the above command, this is your user name

And then execute these steps for each directory listed above in order:

  1. Execute: stat -f "%Su" [directory]
  2. It should output either your username or root
  3. If it says root then execute: sudo chown -R $(whoami) [directory]

Once you've done the above for both directories, start Atom normally and attempt to update :+1: