30 May 2017

macOS version 10.12.0, called "Sierra," was released on 20 Sep 2016. It is a free update to 10.11 El Capitan. This note describes how to update a computer from an older version of MacOS to OS X 10.12 Sierra.

Apple released macOS 10.12.1 on 24 Oct 2016, making some features work better.
A deep security problem was fixed in 10.12.1 that could allow local applications to increase their privileges.
Apple released macOS 10.12.2 on 13 Dec 2016, fixing many security bugs.
Apple released macOS 10.12.3 on 23 Jan 2017, fixing security, graphics, and PDF bugs.
Apple released macOS 10.12.4 on 27 Mar 2017, fixing many security bugs.

You may wish to wait to install Sierra until you are sure it will work for you. I have not installed Sierra and don't plan to until things settle down. See "Show Stoppers" below.

New Features of Sierra

Sierra has user interface changes, including optional integration with iCloud. These features will work best if your Mac has a high-speed, always-on, unmetered Internet connection.

Several features support multiple Apple devices working together:

Should I Install Sierra?

Show Stoppers

Check MacInTouch for the latest status. These are the ones that concern me.

Apple software: Users report that laptops running Sierra use up the battery faster and run hotter, with more fan noise. will not handle encrypted attachments correctly, even if you have installed the necessary certificates. Some folks are missing mail attachments: this may be the same problem. Converting large Mail databases after installation is very slow. Time Machine logging has changed, and some users report that Time Machine is much slower. Syncing Photos libraries to an iPhone using iTunes sometimes hangs forever.

Multiple users report unexplained USB disconnection problems. Devices vanish randomly from the Finder and data connections are lost. Posts on MacInTouch suggest that installing Sierra updates the USB3.x firmware on your Mac, which may be an issue; another theory is that USB3.x is more susceptible to radio frequency interference and needs better cables. If your machine is new enough to have USB3.x support, this may be an issue for you.

Surprising features: Some users report unexpected behavior from the Cloud integration features: if you enable iCloud Drive, the default is to turn on Optimize Storage by default. UNCHECK the Optimize Storage checkbox unless you understand it, and really want to have your Desktop and Documents files stored in the cloud, and deleted from your Mac. (TidBits reports that Optimize Storage may be automatically re-enabled when you update Sierra to a newer version, so check the preference after updating.)

Videos will "autoplay": you can disable this in the FireFox browser address bar, by going to about:config and setting "media.autoplay.enabled" to false.

Third party apps: GPG's plugin for Mail is incompatible with Sierra: a fix is coming. Logitech Control Center causes hard freezes. iStat Menus may have some problems flooding the Console with messages. Quicken Essentials does not run on Sierra. People report problems using Aperture with Sierra.

Hardware support: Fujitsu ScanSnap devices need a driver fix, coming in November: some models won't work and some previously scanned PDFs will turn blank. A full package of drivers for Brother printers and scanners is scheduled for November. Some Canon printers won't work until they get driver updates. Some HP scanners won't work. Wacom Bamboo tablets do not work.


What you Should Do Now to Get Ready for Sierra

Who Can Update

Not everyone can use the new OS version.

Plan your install

When you decide to install Sierra, do it carefully. You may find that there are issues that affect you: do your homework. Check MacInTouch to see if there are problems with OS X 10.12 that affect you.

Make sure you back up your entire disk before starting to install Sierra. Preferably to more than one place.

Make a list of the hardware you depend on, and search the web to check that each device will work. Older printers and scanners can have issues.

Leave yourself enough time. Upgrading will tie up your computer for a big part of a day. Installing takes an hour or two, but then your computer will be very slow until it re-does the Spotlight index and does a big backup up to Time Machine.

Finding PowerPC Programs

PowerPC-only programs on your computer will not run on Sierra. (System Profiler no longer lists the "Kind" of program in its Applications report.) To list these programs, open a Terminal window and type

  system_profiler SPApplicationsDataType | sed -e 's/ *//' | grep -A4 "Kind: PowerPC" | grep Location > ppc.txt

Many of these programs are not problems: they are leftovers from old software installers or previous versions of software. For example /Library/Application Support/Adobe/ If you have questions, contact the manufacturer.

Particular issues before upgrading

Here is a partial list of minimum program versions needed for Sierra. For other programs, check product websites, or RoaringApps.

ProgramMinimum VersionNotes
Microsoft Office2011No longer sold, works if already installed; needs an Outlook patch
Quicken2007 "Lion Compatible" version 16.1.4$15 upgrade
Adobe PhotoshopCS5see Adobe site, must install Java 6, crashes on close?
Adobe IllustratorCCsubscription
Suitcase Fusion 717.3.0$50 upgrade
Little Snitch3.7$17 upgrade
Apple XCode8free with registration
Super Duper2.91$27.95
Apple OS X Server5.2

Installing Sierra

  1. Clean up and update software before installing.
    • (If your Mac is running a very old version of OS X, you must install Snow Leopard 10.6.8 first, in order to get a version of Apple App Store that can download Sierra. Here is Apple's how to upgrade page.)
    • Download Sierra from Apple Software Update or App Store. It is free. This downloads a large file, the Sierra Installer, to your disk. You can create a bootable installer volume on a USB key using these instructions. (But see the TidBits article "Previously Downloaded OS X Installers No Longer Work".) Apple's license terms say you can update all your computers with one purchase.
    • Get the applications on your computer ready for 10.12: apply the latest fixes.
    • Delete junk files. Carefully.
    • Delete Safari, iTunes, and Firefox caches, so your backup will be faster.
    • If you have customized your desktop background or screensaver, write down your settings. Some Apple-provided pictures may not be available in the next version.. make a safe copy of anything you will want after upgrading.
    • Empty the Trash.
    • Clean up damaged and duplicate fonts.
    • If you use Apache, save a copy of /etc/apache2/httpd.conf.
    • If you installed modules via CPAN, Macports, or Fink, make a list of them. In a Terminal window, type
      perldoc perllocal | grep :: > cpan_modules.txt
      port -qv installed > macports_packages.txt
    • Have your software license keys handy in case you have to re-authorize products.
    • De-authorize Adobe Photoshop and Illustrator.
    • De-authorize your computer from iTunes.
  2. Backup and prepare.
    • If you use MySQL, backup the database with mysqldump databasename > db.sql
    • BACK UP YOUR HARD DRIVE to an external disk. I used SuperDuper to clone my whole drive. Some cautious people make two backups.
    • If you installed a third-party Solid State Disk (SSD), check the manufacturer's website to see if you need to update its firmware to work with Sierra.
    • If you connect your Mac to the network using WiFi, select  ► System Preferences... ► Network ► Advanced and delete any WiFi networks you don't want to use. (I forgot to do this, and my computer connected to a very slow network, which slowed down my install.)
    • The best way to handle Macports is to uninstall all the old ports and reinstall after updating the OS. In a Terminal window, type
      sudo port -fp uninstall installed
  3. Install
    • If you use a wireless mouse or keyboard, put in fresh batteries.
    • Set screen saver to NEVER, and turn off Time Machine.
    • Dismount and unplug or power off external drives.
    • Run the OS X 10.12 installer. If FileVault is enabled on your computer, the installer will ask for a password to unlock the disk. It will run for about 15 minutes, then reboot, then run for about an hour, then reboot again. (The "time remaining" will show wildly varying estimates as the installer proceeds. Don't panic if you see a gray screen with "30 minutes remaining" for an hour. Just let it run.)
    • As the update finishes, it will ask you for your AppleID password.
    • If Sierra asks you if you want to enable Desktop and Documents folder syncing to iCloud, the safest thing to do is to say NO. If you say YES, these folders will be backed up in iCloud and available on all devices, which you may not want, and saying YES may also enable "Optimze Storage" which will delete files from your computer's drive if it gets too full. Adam Engst's TidBITS article on Optimized Storage is very helpful.
    • Select  ► App Store... to update to latest versions of Apple software, then run it again to make sure all software is updated. (about another hour) If you just downloaded the OSX installer from the Apple Store, you will have the latest version of OSX, but this step may find additional application updates.
    • Do a "smoke test" to verify that your computer is working OK. Make sure the applications you depend on are still working. (This is where I discovered that Illustrator CS5 had problems.) Try out the applications from Apple that were updated with the OS. If you have trouble, restore your backup and go back to the old OS version.
  4. Recover
    • When you attempt to re-authorize Adobe Photoshop and Illustrator, or the first time you execute them, you may see an alert box that tells you that you have to install Java 6 first (even if you have Java 8 installed). Click "more Info" and download and install the update.
    • Re-authorize your computer in iTunes.
    • Wait for Spotlight to finish indexing (may take several hours). Performance will suck till it finishes.
    • Turn on Time Machine and start your backup.
    • The first time you run, it will want to reformat your mail archive. If you have a lot of saved messages, this process may take a long time.
    • You don't have to repair disk permissions with Disk Utility any more. In fact, you can't; the option is gone.
    • Restart the computer. Often this speeds things up.

Post Install Tasks

Once you are satisfied that your computer works acceptably, and you are going to stay on Sierra, you can make some adjustments.


You will probably want to set up per-user customizations, such as your desktop background and screensaver. After each new OS generation this is something of an adventure; functions get renamed and moved around.

Security issues

Under Sierra, Spotlight "shows suggestions from the Internet, iTunes, App Store, movie showtimes, locations nearby, and more." To do this, it sends your location and query to Apple servers. You may wish to change this if you are required to keep some information private. Change it in two places: uncheck "allow Spotlight Suggestions" in  ► System Preferences... ► Spotlight ► Search Results and uncheck "Safari & Spotlight Suggestions" in  ► System Preferences... ► Security&Privacy ► Privacy ► Location Services ► Privacy ► System Services ► Details.


Programming Tools

  1. In Terminal, type the command java. If you don't have Java 8 installed, this action will bring up a dialog box: click More Info to bring up the Oracle JDK installation page in a web browser, and trigger the installation of the Java 8 JDK from Oracle over the Internet. Java is needed for Eclipse and for other Mac applications, such as OpenOffice and some Adobe products, and VPN clients such as Cisco. Java is not dangerous, if you use it to run code you trust: using it to run web page animations has had some problems.
  2. If you use your computer for programming, install the (free) Xcode Developer Tools by typing xcode-select --install in a terminal window, or by installing the whole Xcode package using the App Store. Then type sudo xcodebuild -license in a terminal window to accept the license.
  3. MacPorts: see my instructions for MacPorts page. Basically the procedure is to list your ports and uninstall them before upgrade, install the OS, reinstall MacPorts, and reinstall your ports. Set PERL5LIB=/Users/myname/bin:/opt/local/lib/perl5/site_perl/5.22 or installs will fail with messages about variants.
  4. MySQL: If you are upgrading from Mavericks or Yosemite and have MySQL 5.6.25 installed, it will continue to work. The Oracle web site provides version 5.7.13 for OSX 10.12. See my MySQL instructions if you want to install it. I had trouble getting MySQL to run until I modified my network configuration to disable IPV6.
  5. Perl/CPAN: See the instructions for upgrading CPAN. I encountered one module that failed to install until I specified "force."
  6. Apache web server:
    • Apache xxx is provided with Sierra, but is not automatically started and there is no System Preferences interface to enable it.
    • The new OS install will not carry over your old Apache customizations. diff /etc/apache2/httpd.conf against your saved copy and edit as necessary.
    • Start Apache using the terminal command sudo launchctl load -w /System/Library/LaunchDaemons/org.apache.httpd.plist. The -w means make it permanent across restarts. (Or buy and install the Apple OSX Server add-on, which gets you a lot of other stuff too.)
    • PHP xxx is shipped with the OS but disabled in httpd.conf. I sometimes enable PHP in order to debug programs that will be deployed in safe environments on other computers. If you enable it, be aware of the risks of making PHP available on the Internet from your Mac, and track and install security updates.

After all installations are done, re-enable SIP by booting into the recovery environment and typing csrutil enable .

Sierra Observations

New Features and Changes

Most of the advertised features of Sierra sound uninteresting or worse to me.

Siri and ApplePay are available on macOS.

Photos will have better face recognition and search.

Apple Watch is integrated with macOS so you can use it to unlock your computer. I have no plans to buy an Apple Watch though.

Clipboard will allow you to copy on one Apple device and paste on another. This sounds like a bad idea to me.

You will be able to back your Desktop and Documents folder up to iCloud automatically, and access them from another Mac... thus introducing new security problems. (This feature only works if you have always-on internet connectivity.) See for an explanation of Apple's security practices. Apple has the encryption keys for encrypted backups, and says that it "never provides encryption keys to any third parties." (This doesn't say they won't unlock it give a court order, just that they won't provide the keys.) Supposedly Apple is working on more secure storage.

When your hard drive gets full, you can have macOS automatically copy files to iCloud and delete them from the drive, and retrieve files back to the Mac when you need them, assuming your Internet connection is working. When your iCloud storage gets full, you can buy more from Apple... one terabyte costs $10/mo.

Messages will let you send very large emoji, and send video links.

Mail ???


Third party apps that appear to work OK:

Bugs/Gotchas in Sierra

Removed Features

Planning for the next version

Keep a list of the software and devices you use and depend on, so you can check that they are supported.

The next macOS version will probably release in Fall 2017.

Home | FAQ © 2010-2017, Tom Van Vleck updated 2017-05-30 18:21