JAMF Nation
CCT Badge

OS X need to repair your library

Posted: 3/31/14 at 2:19 PM by Chriskmpruitt

Hello all,

We have been getting this error since upgrading to Mavericks. "OS X needs to repair your Library to run applications. Type an Administrator's name and password to allow this". This happens on a per user base. A user can login and get this error and logoff and get no error. It seems "random" but we know its not. Just cant seem to connect the dots.

If you navigate to \~/library. It says "The operation can't be completed because the item can't be found". But if you navigate through Computer-->Macintosh HD-->Users everything is there, and has full permissions.

Things we have tried that have failed.

  1. Fix disc permissions
  2. Repaired Keychain
  3. Software update to OS X 10.9.2
  4. Deleted Login Keychain via script
  5. Created a folder in \~/Library/User/keychain @Postimage
  6. sudo update_dyld_shared_cache -root / @Login
  7. Disabling Keychain Update via script

We are using Active Directory Our Users are Managed, Mobile

Any help would be greatly appreciated

CCA BadgeCCE BadgeCUG Badge

Posted: 3/31/14 at 2:24 PM by bentoms

@Chriskmpruitt, are your home folders located on a server?

If your pushing out any DMG's that FEU or FUT's, please check their permissions too.

Posted: 3/31/14 at 4:04 PM by Gillaspy

I was seeing this too, but solved it with just:

sudo update_dyld_shared_cache -root /

based on advice from this thread over at DeployStudio Forums:


CCT Badge

Posted: 3/31/14 at 5:29 PM by Chriskmpruitt

Thank you guys for the quick posts.

Our home folders are not located on a server.

I have been through our DMGs a few times to check if any have FEU or FUT's. Everything looks good there. If that was the problem, we would see it more consistent and not so "Random"

@Gillaspy I really like that thread, it is exactly what we are going through. There is no known "fix" besides just restarting the machine

Posted: 4/1/14 at 9:54 AM by Gillaspy

I was under the impression that the command was fixing the issue before anyone logged into a newly imaged machine, but its true that I was also giving those computers an additional restart, too, so it would make an interesting test to leave out the restart to see if the command is helping at all…haven't done it that way yet.

CCA BadgeCMA Badge

Posted: 4/1/14 at 1:45 PM by Mike_Meyers

I had a same sort of error with the Keychain. After trying to repair it a few times, I recreated my image (updating to 10.9.2) and the issue went away.

CCT Badge

Posted: 4/3/14 at 11:04 AM by Chriskmpruitt

@Mike_Meyers and @Gillaspy are you running Active Directory?

CCT Badge

Posted: 4/3/14 at 11:05 AM by Chriskmpruitt

@Mike_Meyers and @Gillaspy are you running Active Directory?

Posted: 4/3/14 at 11:08 AM by Gillaspy

Yes, all AD, no OD.

CCA BadgeCMA Badge

Posted: 4/3/14 at 12:00 PM by Mike_Meyers

Yes to AD, no to OD.

CCA Badge

Posted: 6/12/14 at 2:23 AM by fabsen83

Hi there,

I just ran into the same issues with OS 10.9.3 and I tried almost everything I could find about this. Last, I tried this on an unmanaged computer with a fresh install and I got the same errors.

"OSX needs to repair your Library to run applications...bla bla"

I figured out some weird permission issues on the users homefolders which are created at the point of login on our Server (Windows Server 2008 R2), where 'Everyone' has delete/deny permissions. I was a little bit wondering about this, so I removed 'Everyone' from the list and applied those permissions to all child objects. By fixing that, I had no issues anymore.

Can't really tell if this is the same problem for you guys because we are using Acronis/GroupLogic ExtremeZip to mount the Shares via AFP from the WindowsServer. Also asked ExtremeZip Support if this is already a known issue with Mavericks, because we had no problems with 10.8.

Our AD client configuration looks like the following:

Active Directory Forest = our.domain.com
Active Directory Domain = our.domain.com
Computer Account = computerName$

Advanced Options \- User Experience
Create mobile account at login = Disabled
Require confirmation = Disabled
Force home to startup disk = Disabled
Mount home as sharepoint = Enabled
Use Windows UNC path for home = Enabled
Network protocol to be used = afp
Default user Shell = /bin/bash

Advanced Options \- Mappings
Mapping UID to attribute = not set
Mapping user GID to attribute = not set
Mapping group GID to attribute = not set
Generate Kerberos authority = Enabled

Advanced Options \- Administrative
Preferred Domain controller = not set
Allowed admin groups = not set
Authentication from any domain = Enabled
Packet signing = allow
Packet encryption = allow
Password change interval = 14
Restrict Dynamic DNS updates = not set
Namespace mode = domain

Maybe anyone else has a similar setup and has some more suggestions regarding this issue.

Thanks & Cheers!

Posted: 7/29/14 at 9:49 AM by jake.snyder

We're having the same problem with Mavericks. We have an all AD environment and we repeatedly get the OS X needs to repair your Library to run applications. This error occurs for new and and old users. Entering credentials to run the repair gives a 30 second window before returning with the same error message.

CCT Badge

Posted: 7/29/14 at 2:41 PM by Chriskmpruitt

have you tried the same steps that we did?

Posted: 8/4/14 at 10:19 AM by kevin5495

Having the same issue here. AD users get the “OS X needs to repair your library to run applications” error, local users work fine. Entering admin credentials doesn’t help.

Instead of mounting AD users SMB share the OS points the home directory to /var/empty.

I haven’t edited the default user template as many seeing this issue have and the update_dyld_shared_cache suggestion doesn’t help.

Oddly, an earlier version of my (monolithic) 10.9.4 image worked fine on new iMacs, when I apply to other machines (late 2013 Mac Pros, late 2013 iMac) it errors. Binding to AD using Deploy Studio plug-in.

This is becoming more unnerving as September approaches.

Posted: 8/4/14 at 12:10 PM by jake.snyder

I tried running sudo update_dyld_shared_cache -root / on the admin side of things, but it didn't seem to help.

I'm at 10.9.4

I also tried a new smb share and made sure the permissions were correct. The problem occurs when the user signs into 10.9.4 \- the home directory on the windows server gets partially created, but the permissions are completely wrong.

I have more luck if I have the account login on a 10.8 computer first, and then login on a 10.9.4 computer.

Posted: 8/5/14 at 4:05 PM by Gillaspy

Under 10.9.4, with AD accounts I am seeing better results if the account is generated under 10.9.1 (and later) and not imported from a record generated under 10.9.0 and earlier. Some sort of directory schema change has seemingly occurred to support iCloud Keychain with the release of 10.9.1:


Unfortunately, following the directions in the article above won't be an option for many multiple user environments and will only help with single-user workstations.

With the AD-based Password change/Keychain update dialog, I am seeing that there continues to be an issue with the "Continue Logging In" button (the OS might complain about no access to various items related to the Keychain), but that "Update Keychain PW" and "New Keychain" work if the directory record was generated by Mavericks 10.9.1+ and not an earlier OSX version (and if the user is correct about what their prior password was for the "Update Keychain PW" button).

CCA BadgeCSE BadgeCMA Badge

Posted: 8/5/14 at 7:28 PM by jruskey

We are seeing the same problem. Brand new out of the box 10.9.4 machines. All updates run. AD Only. Bound to AD. I have an access problem while creating the home folder for a user. Home folder should point to windows server 2008r2 share. On the first logon from any new Mac, the access right to the network home is corrupted. It sets up some folders on the server share, but screws up the security on all folders so we have no access to those folders. If I log in as the same user on a 10.6.8 machine, no problems. It creates the folders in their network share home folder and all security is correct.

Posted: 8/6/14 at 8:21 AM by kevin5495

Testing yesterday I found the same results on an out of the box iMac. I bound to AD using Apple's AD plug-in, restarted, logged in as an AD user and got the same error. Opening a ticket today.

CCA BadgeCCE BadgeCUG Badge

Posted: 8/6/14 at 8:25 AM by bentoms

FWIW, I have not seen this with AD mobile accounts & 10.9.x.

I guess there is a package that you're installing that may be causing the issue.

Posted: 8/6/14 at 8:29 AM by jake.snyder

It seems like @jruskey][/url and @kevin5495 are having the same problems that I'm running into. I just made a bit of progress:

I found that an Everyone Deny permission appears within the home directory folder on the server. If I delete this permission on the few folders that are actually created (Library, Desktop, and Documents), then I can actually save files to those folders. Unfortunately the other default folders are still missing (Movies, Music, Pictures, Public).

I think we'll be able to resolve the issue if we can figure out how to avoid having that Everyone Deny permission attaching itself to folders within the home directory. Could this be prevented by modifying the default user profile?

Posted: 8/6/14 at 12:07 PM by jake.snyder

@bentoms this is happening on a 10.9.4 imac fresh out of the box so it can't be related to packages

CCA BadgeCCE BadgeCUG Badge

Posted: 8/6/14 at 12:26 PM by bentoms

@jake.snyder, so it looks like your AD homes are located on an SMB share right?

When you say "fresh out the box" do you mean the local admin account on the OS supplied by Apple?

Really not seeing the same issues as you, so it may help if you detailed some more of your setup. Perhaps there is some commonality.

Posted: 8/6/14 at 12:32 PM by kevin5495

In my case I created the local admin account as part of the AppleSetup wizard. No updates, no packages. The other thing I touched was Directory Utility. Because the AD home directory pointed to /var/empty we're looking at AD now.

Posted: 8/6/14 at 12:38 PM by jake.snyder

@bentoms][/url good call, let me provide more detail

Our AD homes are located on a SMB share (windows 2008 R2). I verified that the permissions on the share are setup exactly the way Apple recommends for Mavericks (I was even sent a custom made video by an Apple engineer detailing the permission and security settings for the share so those should be perfect).

I then took a brand new imac that came with 10.9.4 already installed and signed into a local admin account and then bound it to AD using the mac AD-plugin. I signed out and restarted the computer, and then tried signing in with a fresh AD account that was pointed to my AD home directory share. I can sign in just fine, but I immediately get the “OS X needs to repair your library to run applications" error. I can't save or do much in the environment when it does this.

If I look at the permissions of the newly created home directory for my fresh AD account it looks kind of funny \- only the Library, Documents, and Desktop folders were created. I noticed that there was an Everyone Deny permission on each of those folders and when I delete the Everyone Deny permission on each folder (Library, Documents, Desktop) I can actually use the account and save documents. If I log out and back in after those changes, the other typical home directory folders are still missing.

Edit: I should note that I don't have this problem with 10.8.x or 10.7.x

CCA BadgeCCE BadgeCUG Badge

Posted: 8/6/14 at 1:15 PM by bentoms

@jake.snyder, yea I don't know. It's not something I do.. & tbh, my "it doesn't happen to me" wasn't helpful. Sorry.

Which Mac OS has this worked on before?

CCA BadgeCSE BadgeCMA Badge

Posted: 8/6/14 at 1:30 PM by jruskey

@jake_snyder, Your symptoms are identical to what we are seeing. I have been working on this for 2 days with no luck. Considering go to 10.8.x on the new imacs to see if that fixes the issue.

Posted: 8/7/14 at 10:04 AM by agrosvenor

@bentoms, this has worked on 10.8.5 and all previous versions \-

@jruskey, \- I suspect rolling back to 10.8.x will work \- it did for us, but we are still trying to get 10.9.4 operational for this upcoming semester

[for reference, I work in the same department as @jake.snyder ]

CCA BadgeCSE BadgeCMA Badge

Posted: 8/7/14 at 11:02 AM by jruskey

@bentoms][/url][/url][/url, @agrosvenor][/url][/url, I can't roll back. These all shipped with 10.9.x and not matter what I try, it won't allow 10.8.x to install. So, back to the fun.

Posted: 8/7/14 at 11:27 AM by jake.snyder

@jruskey that's really unfortunate, @agrosvenor and I haven't made any progress in the last 24 hours

Posted: 8/7/14 at 12:42 PM by jake.snyder

we were assigned an Apple engineer from Apple Enterprise Support this morning so we'll see if we can make any progress once they reach out to us

CCA BadgeCSE BadgeCMA Badge

Posted: 8/7/14 at 1:06 PM by jruskey

@jake.snyder, There is the obvious problem of the home directories not mapping. We are all experiencing that. Let me know what they say. I have confirmed if I use AdmitMac from Thursby, my home drives mount correctly. Now, that isn't the solution since it is about $70/machine for that plug in. However, even if we paid the money for that, the other issue is that no network users can log in after the Mavericks machine goes to sleep. You either have to reboot or log in with a local account, log out and then network accounts are fine. Are you also lucky enough to have this other problem as well?

Please let me know what your apple engineer says. Thanks so much.

Posted: 8/8/14 at 9:46 AM by Olivier

We also have our AD homes on a SMB server, but quite frankly, I don't think this is the root cause. Same for the udld force cache.

I also have seen couple of times this since 1 or 2 years now, and the only thing I could notice when pb happens, is a mismatch between the UID in the Directory service record for that user (dscl . -read /Users/yourADuser ) and the UID seen on the user's Library folder on disk (run a simple "ls -lnr /Users/yourADuser/Library").
Remember that OSX silently checks, and updates if needed, any user's record entries during session logon (99,999% of the time, there is obviously nothing to update but...) : this is what maybe created the permissions mismatch and the annoying popup.

CCA BadgeCSE BadgeCMA Badge

Posted: 8/8/14 at 9:59 AM by jruskey

This happens with old users, brand new test users created, etc. It is every network user. It is only on 10.9.x. Any other versions from 10.6.8 and up, no issues whether new or existing user.

Posted: 8/8/14 at 5:08 PM by ebioit

We are seeing the same error on our older classroom computers. Our Mid 2009 MacBook Pros and Early 2009 iMacs prompt us after imaging: "OSX needs to repair your library in order to run applications..." Furthermore they fail to bind to the active directory at imaging time. If we log into the Local Admin and repair the library when prompted \- we are then able to manually bind the computer to the AD furthermore, the required applications work for the Local Admin and AD users.

Our newer computers (Late 2009 +) do not display the repair message and bind to the AD. Imaging is a flawless process on these iMacs and MacBook Pros.

We are using 10.9.4 build 13E28 images created from AutoDMG \- its quite the predicament, we may end up imaging our classroom computers with 10.8 again. This is the first time I've experienced the age of a mac producing different imaging results in such a manner.

CCA BadgeCSE BadgeCMA Badge

Posted: 8/11/14 at 6:18 PM by jruskey

@jake.snyder, has your apple engineer been able to resolve anything as of yet?

Posted: 8/11/14 at 7:09 PM by jake.snyder

@jruskey not yet, they've been getting pretty deep into logs and verifying what we're seeing, I'm hoping for a resolution soon. I'll post on here as soon as I get anything.

Posted: 8/11/14 at 7:14 PM by jake.snyder

@ebioit have you tested brand new accounts with network home directories on 10.9.4? I'd be curious to see if you have success or not.

CCA BadgeCJA BadgeCMA Badge

Posted: 8/12/14 at 7:19 AM by michaelhusar

I saw the same things with old user accounts from 10.8 when we moved to Mavericks. We saved the work-data and made a new account/library.
Base OSX 10.9.4 is from AppStore and packed with Composer.
Before that we were also exploring the everybody-deny-delete-road: We removed that ACL from the user template and wrote a launch agent for removing. But OSX "repairs" that \- so you always end up with files with everybody-deny-dele-ACL in the Library. The only remedy we found was ExtremeZ-IP (handles the ACL correctly).

Posted: 8/13/14 at 8:30 AM by jake.snyder

@michaelhusar @jruskey I just downloaded the trial of Acronis ExtremeZ-IP and can confirm we didn't have account corruption when using AFP, but it still only created three folders (Desktop, Documents, Library).

I'm still waiting for next steps from the kind folks at Apple. They are very detailed and thorough but I'm afraid I won't have time to wait for their solution.

I'm preparing two options for the scenario where Apple can't figure it out in time for the start of my school year:

  1. Roll back to 10.8.5 on iMacs that will support it and run forced local home directories on our 20 brand new imacs \- less than ideal for those that will need to use these computers.
  2. The other option is to implement Acronis ExtremeZ-IP, but the unlimited client licensing is expensive for a technology that Apple is moving away from.

Michael \- Do you have instructions or tips for how to setup ExtremeZ-IP? I followed the instructions I found for version 3, but they seem slightly dated. It seems to be working except that its only creating 3 folders.

Thanks all. If Apple support comes through, I'll post a follow up here.

CCA BadgeCSE BadgeCMA Badge

Posted: 8/13/14 at 8:40 AM by jruskey

@jake.snyder \- I understand your frustrations. What we did with the labs that can't be downgraded is similar to option 1. We created a generic local login since it is in a lab. Then, we have Aliases on the desktop that allow users to connect to their home directories, shares, etc. Not ideal, but didn't have a lot of options.

I did use AdmitMac from Thursby and it works very well. I think education pricing is about $132 per license($110 for the license and $22 for support). The more licenses you purchase, you get volume pricing. It works very well, but it is expensive. We ended up purchasing a 5 pack for the machines that we are rolling out to staff that won't be in labs.

If you hear anything from apple, let me know. Thanks so much.

CCA BadgeCJA BadgeCMA Badge

Posted: 8/13/14 at 8:46 AM by michaelhusar

sure: Security:
NoCheck Allow Mac clients to change permissions
Check Reset permissions on move
Check Support UNIX permissions
Check Support ACLs on all volumes
Check(ed) Show only accessible Folders \+ Files
Directory Services:
Check Global Catalog: We have a AD-Account for that

Check Index volumes for search

Other stuff is default/no game changer I guess.

At the first sync I also see only 3 folders \- it seems to build up incremental \- as the user needs the stuff.

I use a Profile Manager Config to set what gets synced.
I use the defaults of "mobility" on \~/Library
with these exclusions

\~/Documents/Microsoft User Data/Entourage Temp
\~/Library/Application Support/SyncServices
\~/Library/Application Support/MobileSync
\~/Library/Calendars/Calendar Cache
\~/Library/Mail/V2/MailData/Envelope Index
\~/Library/Preferences/Macromedia/Flash Player
\~/Library/iTunes/iPhone Software Updates

and also added those:

\~/Library/Mobile Documents
\~/Library/Application Support/AddressBook/Sources
\~/Documents/Microsoft User Data

in future probably
\~/Library/Containers, \~/Library/Accounts, \~/Library/IdentityServices, \~/Library/iCloud

One other thought: Do you use a Win2012 Server? I had to make sure the SPNs are all low letters (!) otherwise Kerberos does not like it and there are on and off sync problems.

Posted: 8/13/14 at 9:32 AM by jake.snyder

@michaelhusar thanks for your quick response!

My ExtremeZ-IP settings were fairly close to yours except for the "reset permissions on move" and "show only accessible". I made adjustments to my settings to match your settings. It's good to know that you're seeing the three folder thing initially as well.

I will be using folder redirection mostly for Adobe related cache.

We're using Windows Server 2008 R2, but the SPN is already lower case. Good to know though!

Thanks again!

Posted: 8/13/14 at 10:34 AM by dhandy

@jake.snyder Jake, I've been following along with the same issue, and eagerly awaiting the response from your Apple engineer.

I also have Everyone ACLs getting explicitly set on new Windows Server 2008R2 home folder items by Mavericks 10.9.4. My only workaround at this point, has been to build my own "User Template", by logging into Mavericks as a local user, logging out, then ditto'ing the created local home folder up to the server.

I then strip off the everyone ACLs: icacls U:\Students\username /remove:d everyone /t /c /q /l on the home folder, then grant full control to the user.

Interestingly, any folders manually created by the user aren't handicapped by these everyone ACLs, but any folders/items created by Mavericks OS processes are.

Those user home folders that I migrated over from an Xserve file server don't have this problem.

Posted: 8/15/14 at 9:59 AM by jake.snyder

@dhandy @jruskey @michaelhusar @ebioit

I just got this update from Apple, but haven't tried it yet:

After some more testing I have been finally able to reproduce the reported issue and found a solution in order to address this behaviour.

Could you please check in your Home share properties under advanced if you have a Feature enabled called: "Enable access-based enumeration" ?

If this is correct please remove the nsmb.conf ( $ sudo rm /etc/nsmb.conf ) global Configuration again and disable this feature.

After this has been disabled create one more Test user, restart the Client and try to login with this new user account after restarting.

Posted: 8/15/14 at 10:16 AM by dhandy


FWIW, access-based enumeration is off for me, and has never been enabled on the new share points I set up on a new server.

Here's my scenario to recreate the issue (sorry for the length):
Active Directory/Open Directory bindings
Student Network Home folders on Windows Server 2008 R2
Mavericks 10.9.4 clients, OD server is OS X Server 3.1.2

Steps to recreate:

Create a new user in AD.
Active Directory creates the empty home folder with the user's name, when path entered in Home Directory attribute in AD. (Without this, user login denied.)

Permissions on empty home folder automatically set with new user in Full Control over subfolders and files, and System and Administrators Full Control propagated down by inheritance from parent share point.

Then, first login by user on Mavericks client, Mavericks populates the empty home folder with a Spotlight folder, Library and Downloads folder (no use of /System/Library/User Template)

"Downloads" inherits home folder permissions, and sets explicit Everyone Deny Delete this folder only.

Library also inherits home folder permission, and sets explicit Everyone Deny Delete this folder only.
*ALSO sets "S-1-5-88-3-448" Deny None this folder only.*
*** (This SID translates to Everyone) \- This is where problems start.

Client user login experience shows "Keychain Not Found". Attempts to Reset to Defaults repeats twice. Then error "Home folder for user isn't located in the usual place or can't be accessed" User can't get to home folder at all.

Logout, and user can't login again. ("Unable to login at this time.")

If I run the following command, to remove the "Everyone" ACLs on the Windows Server, the user can login again.

icacls U:\Students\username /remove:d Everyone /t /c /q /l

Home folder now accessible to the user, with no keychain error. Desktop folder now available (permissions set again with Everyone Deny Delete). No Documents, Pictures, Movies, etc. yet.

Various other Library sub folders and Library items are created by the client OS, but permissions on these items are all set to explicit "Everyone Deny Delete this folder only" and "S-1-5-88-3-448" Deny None this folder only" on everything.

The user can create a folder in their home folder, but there's no "everyone permissions" set, and looks normal.

*My current workaround is to create the user's home folder as a local home folder, login, logout so it gets populated, then ditto this local home folder to the server. I then delete the everyone ACLs, and grant the user Full Control over their server home folder.*

Hopefully this is aligned with the symptoms you're seeing. Otherwise, I'm in the wrong thread.

Posted: 8/15/14 at 10:55 AM by jake.snyder


I'm seeing something a bit different than you, but the issue is related. Perhaps its because I'm not using Open Directory. My home folders are created on first login too.

Posted: 8/15/14 at 10:57 AM by jake.snyder

@dhandy @jruskey @michaelhusar @ebioit

Significant progress today: My environment seems to be working with Access Based Enumeration off and forcing SMB1 on each client.

In order to enforce SMB1 on a mac client:

  1. Create the Global Config: $ sudo -s $ sudo echo "[default]" >> /etc/nsmb.conf $ sudo echo "smb_neg=smb1_only" >> /etc/nsmb.conf
  2. Restart the OS X Client
  3. create a new AD Test user
  4. Login and check if the issue still persist

Posted: 8/15/14 at 11:01 AM by jake.snyder

I'm still seeing these permissions with the above changes, but I'm still able to write:

Deny S-1-5-88-3-448 None <not inherited> This folder only

Deny Everyone Delete <not inherited. This folder only

Posted: 8/15/14 at 11:29 AM by dhandy

Forcing SMB1 Only now allows login and creation of Library folders, so that's a great step! But there's no observance of the /System/Library/User Template for new home folders. (But this may always have been true in the auto-creation of new SMB home folders \- I don't know.)

For instance, launch iPhoto on a new home folder, and it can't create its own database due to the absence of a Pictures folder.

Guess we can't have everything.

Posted: 8/15/14 at 1:51 PM by jake.snyder

@dhandy I noticed that those folders eventually get created, not sure why its not happening all at once like it used to though

Posted: 8/15/14 at 1:51 PM by jake.snyder

Adobe CC is working on network homes, which is huge. Notes and Photo Booth do not work.

Posted: 8/15/14 at 2:50 PM by jake.snyder

Apple support engineering can replicate these issues and they been elevated to product engineering. That's all she wrote folks. Good luck!

Posted: 8/15/14 at 2:54 PM by kevin5495

Thanks for pushing this. My understanding is we may see something in 10.9.5.

CCA BadgeCJA BadgeCMA Badge

Posted: 8/15/14 at 7:17 PM by michaelhusar

To let you know we are on the same page: I was also setting my clients manually to SMB1 and seeing the (so called) "ghost-user" S-1-5-88-3-448
And iPhoto also prompted me for a new Photo-Library

Good to know I am not alone with these observings \- also Thanks from my side for pushing this. We invested in ExtremeZ-IP because of this "feature" \- would be great to operate without these extra costs.

Posted: 8/18/14 at 12:43 AM by joe.farage

Hi all, we also had almost all the problems you describe here. Last year we used Remote Home Directory (AD and Windows Server or NetApp) for our schools. We had to switch back to Local accounts. We had many problems:
\- permissions corruptions => user cannot login; even if we had a script to correct permissions on Windows Share there was still lot of problems.
\- some apps don't work using Remote Home Dirs, need to much hacks.. sometimes nothing works
\- User Template never worked with Remote Home Dirs => plists had to be install with Login Hook at first login
\- For many users it took so much time to login (more than 2 mins)

We decided to come back to Local Home Dirs (using AD) and of courses users were not happy to lose this functionality.

Posted: 8/19/14 at 4:10 AM by eWhizz

The problem is with the \~/Library/Containers folder in your Network homes. This folder and its contents are not being created with the correct permissions. This folder needs to be writeable by more than the User that owns it.

There are processes like soagent and others that seem to need to write things in this folder, but don’t do it as the user. They may well do it as root, but this is no good for Network homes.

I too have yet to find a definitive answer to this problem, but hopefully this little bit of information helps.

The problem was quite prevalent with 10.9 and 10.9.1 with many improvements to this with 10.9.2, however I am still seeing the issue occasionally.

Removing the Containers folder and recreating it with quite open permissions seems to at least work around the issue for now.

This may well be why people that are editing the User Template are seeing this problem the most.

Posted: 8/19/14 at 7:53 AM by jake.snyder

@eWhizz @joe.farage

We're building out the DUT on an iMac and then putting it onto the server in each users home directory because its not being created as expected. This allows us to setup the Finder and Dock the way we want it. In AD, we setup the profile as Z: //SERVERNAME/sharename$/%username% which creates the initial folder we need to copy the DUT into.

We haven't run into the \~/Library/Containers issue yet. I haven't looked for it either. What does this prevent or what issues does this cause?

We redirect \~/Library/Caches, and remove this folder from the DUT. This is primarily to avoid the Adobe caches passing over the network.

Last year we had a few permission issues scattered throughout the year (maybe 4-5). In those instances, we just added a 2 to the end of the home share path and then copied over the files they needed. Not ideal, but it worked on the fly.

CCA BadgeCMA Badge

Posted: 8/19/14 at 1:23 PM by thall

I finished building my very first image using composer and casper admin. 10.9.4 for iMacs. I felt great about my accomplishment and then started logging into some network accounts and ran into this same issue. I captured the OS image from a manual install, then target booted the iMac.

My trouble is that I am not mapping the users to any servers. Is there something I can reconfigure to fix this? If I am reading the posts right it seams to be a mapping issue.


Posted: 8/21/14 at 12:05 AM by eWhizz

Let’s get this straight. The error is because the system or agents running in the background can’t write correctly to a users’ Containers folder.

The “Containers Issue” IS THE ISSUE that causes the “Library needs repairing” errors.

Make sure the permissions on that folder are correct. i.e. fully writeable by the user and others.

If you are creating a User Template (which I think you shouldn’t be) then make doubly sure the permissions are correct, all the way through that folder.

Also a lot of the apps that use the Containers folder (i.e. those that are ‘Modern’ and correctly use and specify their Sandbox requirements) will create symlinks to other folders within your Library and Home folder. These folders probably need to exist.

They will be (amongst others)



If these folders in particular are being redirected elsewhere, then that could be the root of the problem.

This again is the reason why a User Template shouldn’t be used for Mavericks. Too difficult to keep track of all the symlinks etc within the Containers folder.

Still no definitive answers with my post here, but hopefully helps someone else find that answer to their particular cause of the “OS X needs to repair your Library" messages.

CCA Badge

Posted: 9/2/14 at 11:29 AM by TheSeans

I just started seeing this. I deployed out 120 new macs with my 10.9.4 image. Everything was perfect for 2 weeks then my users started getting these errors.

The strange thing is it's fairly random. I can't find any differences in package deployment or profiles on ones that are having and issue and the ones that don't.

Posted: 9/13/14 at 8:15 AM by Swift

Our setup \- Mac clients bound to AD, with network home directories located on a MS Server. No Mac Server, no OD, no symlink redirections of cache folders etc. No special setup.

This is what appears to be happening...

When a user logs in, the Mac OS does some kind of sanity check on the users home directory.

If a users home directory fails this sanity check, the OS will attempt to create missing files and folders, and assign what it thinks are the appropriate ACLs.

If you have your user home directories on a MS Server, these explicit ACLs appear to prevent the user from accessing the home directory.

Examining the properties of users home directory folder shows the explicit ACL

0: group:everyone deny delete

The result of these explicit ACLs, is that the user is prevented from seeing his home folder.


OK, you now have two options.

  1. Setup your shares with permissions that prevent the average user from modifying ACLs.
  2. Create the files and folders that the OS expects to find in the user home before the finder loads. This can be done in a login script.


Option 1:

The fact that the troublesome ACL has been successfully added, is a consequence of CREATOR/OWNERs being able to add or remove ACLs on files and directories. This seems to be standard practice.

Most shares are set up similar to what is described in TechNote http://technet.microsoft.com/en-us/library/cc736916(v=ws.10).aspx

If you have a choice, I would suggest preventing normal users from modifying ACLs. This means deviating from the suggested TechNote norm which might have other consequences.

I have to preface the following with the suggestion that If you are going to try this, do it on a test share first!

The following is taken from my notes from a while back \- when I had my own MS File Server dedicated to our Mac users. Our Mac users now make use of the organisations PC shares, which are maintained by a different team, so I have to admit that I haven't tried this for a while.

-- Firstly, modify the Share level (SMB) Permissions for the Share (default shown in TechNote Table 7.13)

Right-Click on the share > Properties > Advanced sharing > Permissions > Add...

"Add" sharing permissions to allow Everyone: Read
Authenticated Users: Change, Read
Administrators: Full Control, Change, Read

If you have any file admin groups that need to modify ACLS, you should add them here with the same permissions as Administrators above.

-- Next, modify the "Creator Owner" permissions on the Share (default shown in TechNote Table 7.12)

Right-Click on the share > Properties > Security...

Creator Owner: Subfolders and files only \- everything EXCEPT: Full Control, Change permissions, Take ownership

These settings will prevent normal users from modifying ACLs, nipping the troublesome ACLs in the bud.


Option 2:

Since I do not control our MS File server(s), I had to go for this option.

It appears that if you create the following files and folders before login, things will be OK.

All the folders and files in /System/Library/User\ Template/English.lproj (minus the ACLs!)

The file loginwindow.plist appears to be important. This file must exist, otherwise the home folder will fail the sanity check, and the system will re-apply the troublesome ACLs.

I am unsure as to whether the OS inspects the contents of this file as part of the sanity check, I might find out the hard way when I update to 10.9.5. On my 10.9.4 clients loginwindow.plist contains the following:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict> <key>BuildVersionStampAsNumber</key> <integer>27526016</integer> <key>BuildVersionStampAsString</key> <string>13E28</string> <key>SystemVersionStampAsNumber</key> <integer>168363008</integer> <key>SystemVersionStampAsString</key> <string>10.9.4</string>

I create all these files and folders in my login script.

This appears to have fixed the issue for me.


Whatever option you choose, you will still need to jump on the MS Server and fix the permissions on the home directories of all the locked out users \- which is a big pain.

CCA BadgeCJA BadgeCMA Badge

Posted: 9/17/14 at 5:43 AM by michaelhusar

Thank you for the interesting analysis. Did you also try to use portable home sync to create the necessary folders? Or does it kick in too late?
...I was thinking to put the loginwindow.plist and the other necessary folders in the User Template of the Base Image and then set the mobility configuration profile to "use local template" for creation....
But I am afraid during the "life" of the user home folder there will be a lot more files with ACL everyone deny delete...

Posted: 9/23/14 at 5:30 AM by mark.mahabir


Would you be able to share any details re those official permission/security settings recommendations for Mavericks?

Posted: 9/23/14 at 8:22 AM by dhandy

Following up on my earlier posting, now running clients with Mac OS X 10.9.5 against Active Directory and Windows Server 2008R2 network home directories:

I made my own "user template" by creating a local user account on a Mac, then logging in, logging out so that the home folders, Library prefs, etc. get initialized. I copied that home folder up to the Windows Server to use as a template when creating new users. (I delete the contents of the Library/Keychains folder in the template.)

After creating a new user in Active Directory, I then populate their new home folder using my "Generic" template.

robocopy \Users\Generic \Users\studentUser /copyall /e /sl
\# copy empty folders and symbolic links

I then strip any wacky everyone ACLs that might have been created by Mavericks. (I also run this command nightly on all users on my server.)

icacls \Users\studentUser /remove:d everyone /t /c /q /l

I add a user's Full control AND Inheritance ACL on all folders in their home folder:

icacls \Users\studentUser /grant:r studentUser:(OI)(CI)F /t /c /q /l

I then set the owner to be the studentUser. (Helps? I don't know, just feels like I should.)

icacls \Users\studentUser /setowner studentUser /t /c /q /l

Logging in, and logging out users under Mavericks has worked better. (I still run that nightly command above on the server to strip those everyone deny ACLs that crop up.)

I am setting clients to use SMB instead of SMB2, by creating the /etc/nsmb.conf file on clients...

FWIW, my Advancing Sharing Permissions for the share point is set to give Everyone Full Control. (When set to use SMB2, I did try just giving everyone Read/Write, and that removed the Everyone Deny ACL problem. But users of Apple Pages and other Apple apps started seeing multiple copies of documents appear as they saved/revised/saved (old versions weren't getting auto-deleted.)

So, downgrading to SMB and the steps above seem to be working.

Next problem to deal with... Mobile User FileSync under SMB flags uploaded documents as Hidden on the Windows Server. Users are prevented from seeing those files if the log into other Macs as regular network users, or use Connect To Server to get to their server home folder.

CCA BadgeCSE BadgeCMA Badge

Posted: 10/14/14 at 5:50 PM by jruskey

@jake.snyder did your apple engineer ever give you a manageable solution to resolve this or is it basically to wait for Yosemite and hope it is fixed?

Posted: 10/17/14 at 12:40 PM by anderb54

Well, unfortunately upgrading to Yosemite didn't solve this issue either. This is really a bummer. Our students use the macs to do things like iMovie. Before Mavericks, all of their files would be in there server home directory and they could edit on any mac on the network. If anybody finds a fix, please post!!! Really need this working!

Posted: 10/21/14 at 9:37 AM by anderb54

I'm finding that a work around is simply creating the Pictures, Movies, and Music folders in the network home folder (as those seem to be the ones that are missing in my case). So far the first couple I have tried allows users to use iPhoto, iMovie, etc. and no Library repair errors. Not very good solution when you have 100s or 1,000s of users however. Also, they will need to create a new iPhoto library in the Pictures folder.

If the user has logged in before Mavericks, no issues as those folders are already there.

Posted: 10/23/14 at 12:36 PM by jake.snyder

@jruskey we did not get any sort of ideal solution and Yosemite has the same problems. They admit there is a problem, but haven't fixed it.

To get things to work I forced smb1 on the clients and disabled Access Based Enumeration on the server. This seemed to work for awhile, but the "everyone, deny, delete" permissions kept coming back so I've been experimenting with permissions by following @Swift recommendations:

"Next, modify the "Creator Owner" permissions on the Share (default shown in TechNote Table 7.12)

Right-Click on the share > Properties > Security...

Creator Owner: Subfolders and files only \- everything EXCEPT: Full Control, Change permissions, Take ownership

These settings will prevent normal users from modifying ACLs, nipping the troublesome ACLs in the bud."

Posted: 11/6/14 at 3:30 PM by jake.snyder

just following up here, definitely follow the permission suggestions posted by @Swift or you'll have a very bad time...

Creator Owner: Subfolders and files only \- everything EXCEPT: Full Control, Change permissions, Take ownership

Posted: 11/13/14 at 6:53 PM by flowirin

i've had this same problem.
I'm using profile redirection and document redirection via AD and group policy (both say the same things) synchronised from an external database,
logging into PCs was fine, but fresh 10.8 macs bound to AD all had this error for their users
i've been working on a scripted solution, which works for new users, where i manually create this lot:
$homeFolderlist= @( ("$user"), ("$user\$Desktop"), ("$user\Downloads") , ("$user\Favorites") , ("$user\Library"))

then set the acl permissions accoring to this list: $rights = "ListDirectory, ReadData, WriteData, CreateFiles, CreateDirectories, AppendData, ReadExtendedAttributes, WriteExtendedAttributes, Traverse, ExecuteFile, DeleteSubdirectoriesAndFiles, ReadAttributes, WriteAttributes, Write, Delete, ReadPermissions, Read, ReadAndExecute, Modify, Synchronize"

$useranddomainname = New-Object System.Security.Principal.NTAccount("DOMAIN\" \+ $user) $Ra5 = @( ("Everyone"), ("Delete, Synchronize") , ("None"), ("None"), ("Deny") ) $Ra3 = @( ("CREATOR OWNER"), ($rights) , ("ContainerInherit, ObjectInherit"), ("InheritOnly"), ("Allow") ) $Ra2= @( ("NT AUTHORITY\SYSTEM"), ("FullControl") , ("ContainerInherit, ObjectInherit"), ("None"), ("Allow") ) $Ra1= @( ("BUILTIN\Administrators"), ("FullControl") , ("ContainerInherit, ObjectInherit"), ("None"), ("Allow") ) $Ra4= @( ("$useranddomainname"), ("FullControl") , ("ContainerInherit, ObjectInherit"), ("None"), ("Allow") )

which works.
i've not managed to get existing users copied over from an old OD server to work reliably, yet. definitely an ACL thing but im having issues with [ and ] and ( ) and path lengths within powerscript.

Posted: 11/19/14 at 10:43 AM by agrosvenor

We have implemented all of the suggestions here for SMB1 & fixing ACL's \- worked great for a little while.

We are now seeing intermittent issues where users on 10.9.5 cannot move files again \- they receive the "Finder needs an administrators username and password" dialog. When looking at the Windows share, the rogue ACL's have not returned to the account, but they are still unable to move items. If the user logs out & back in, they are able to move files as expected, without the administrators dialog.

Anyone else seeing this behavior, or have any suggestions on where to look next?


Posted: 11/19/14 at 11:26 AM by kevin5495

Testing in 10.10.1, not seeing this issue anymore when binding from Directory Utility.