Moving home directory

I am trying to move my home directory to an external SSD drive to relieve a problem with space becoming very tight on the internal system drive. I am trying to follow the procedure in this article:


https://www.lifewire.com/move-macs-home-folder-new-location-2260157


I am stopped at the first step: if I drag my home directory to the external drive, I get "The operation can't be completed because <home directory name> needs to be downloaded."


I believe this is because there are files in it (particularly in ~/Library) that sync with a cloud server (specifically OneDrive). In fact, my Library folder is shown greyed out in the Finder, although it can be opened just fine.


Is there a way to work around this problem, even if it involves reinstalling the OS from scratch? If so, how? If I restore my home directory from backup, it will contain the cloud-based files (I know this because I did it recently; this machine is new) and I'm pretty sure I will just be back in the same place.


Any guidance would be appreciated, assuming this is possible.

MacBook Pro 16″, macOS 13.1

Posted on Dec 23, 2022 5:25 PM

Reply
Question marked as Top-ranking reply

Posted on Dec 23, 2022 5:58 PM

elisatems wrote:

I am trying to move my home directory to an external SSD drive to relieve a problem with space becoming very tight on the internal system drive. I am trying to follow the procedure in this article:

https://www.lifewire.com/move-macs-home-folder-new-location-2260157

I am stopped at the first step

Good. Because those instructions are wrong, wrong, wrong.

if I drag my home directory to the external drive, I get "The operation can't be completed because <home directory name> needs to be downloaded."

I saw your other thread. I'm pretty sure you are going to have to wipe the whole hard drive and restore from backup before you can successfully accomplish this.

Is there a way to work around this problem, even if it involves reinstalling the OS from scratch? If so, how? If I restore my home directory from backup, it will contain the cloud-based files (I know this because I did it recently; this machine is new) and I'm pretty sure I will just be back in the same place.

All I can tell you is the correct procedure. It is based on this Apple Support article: Change the name of your macOS user account and home folder - Apple Support, with the following changes:


Rename the home folder

4) Make a copy of your old home folder on the external drive. I think a regular Finder copy will work. Being a developer, I would be more likely to use the "ditto" command like:


ditto /Users/jdaniel /Volumes/External/Users/jdaniel


Then rename the account (you aren't renaming though. I'm just using this header as a reference.)

5) In the "Home Directory" section, click on the "Choose" button. Choose the new folder you just copied to the external volume.

6) Don't do this step


The important part here is that you have to be logged out while attempting this. Even if your home directory wasn't corrupted before, if you try this while logged into that account, it will be corrupted afterwards.


A nice point too is that once you are done, you will have a backup admin account that resides only on the boot disk, which you definitely want if you have your home directory on an external volume.



Similar questions

36 replies

Dec 24, 2022 5:31 AM in response to elisatems

elisatems wrote:

So do you think my safest bet is just to wipe the internal drive, reinstall the OS and then restore my account from a backup, before redoing the home directory move the right way?

I don’t know. Maybe try to get a second opinion. There is always a risk a major restore like that anyway.


I’ve just seen many low-level inconsistencies that make me question popular practices. I once lost all continuity/handoff functionality from duplicating an installation. I try to warn people about that, but they don’t believe me because they don’t use those features so they didn’t notice the problem. I’ve seen other things that lead to massive internal database confusion that I don’t like. But no one else ever looks at those databases so they don’t notice. Personally, I think these kinds of issues are what causes certain computers to run 2-3 times slower than others. They still run very fast, faster than your old 2010 model, but not like it should and not with the performance that you paid for. Yet most people never notice that.

Dec 24, 2022 7:16 AM in response to elisatems

Correct, but I did make one critical mistake which, according to @etresoft, could cause inconsistencies that only show up much later down the line: namely, that I did the actual copying while logged into my account.

Yes, and I tried to explain that I'm not sure that will cause any problems.

I can't tell from the man page if ditto preserves permissions (it has an option for ACLs which is on by default).


And guess what? man is still trying to call /bin/more and thus I can't read any man pages on my Mac.

I think you said that man works normally for you. Which version of MacOS are you running?

I'm running 13.1.

I'm trying to determine if this might be a bug in 13.1. The other possibility is that Migration Assistant overwrote something when restoring my files.

I don't think it will overwrite newer system files. However, it could be something in your config files which probably will get overwritten. Did you ever try in a new user account? I can't remember.


From another unrelated thread, I found out that man was once a binary, but now is a script. If you migrated something that supported the binary, it could be something in the configuration files causing your issue with man.


Dec 26, 2022 4:46 PM in response to etresoft

Okay, how about this solution? Leave the ~/Documents directory on the internal drive with its default permissions, ACL, and whatever extended attributes it has, but clone it to the external drive and then empty the original of all user content (except, maybe, for a symlink to the Documents directory on the external drive). Then tell the Finder to open all new windows in the external Documents directory and put that directory in the sidebar. That seems transparent enough at least at first glance. Anything I'm forgetting? Is that also a time bomb?

Dec 26, 2022 5:39 PM in response to etresoft

You can do what you want with your own computer. But I can't help with any hacking like that.

How is that hacking? The directory is intact, it's just empty. If Apple's OS assumes that all of your content is inside the directories people normally put content in, then its design is completely brain-dead or worse, user-hostile. Are you saying that the OS will someday torpedo any file that isn't in one of the special locations mandated by Apple? That's totally insane, why would anyone design a system like that? And if that's true, what use is an external drive unless you put your home directory on it? From what I see, many users have external drives but they don't move their home directory. How can that extra space be safely used?

Dec 26, 2022 6:30 PM in response to elisatems

elisatems wrote:

How is that hacking?

That's not the way the system was designed to work. Any effort to get software to work in a manner that the developer did not intend is a hack. There is no way to predict what will happen.

If Apple's OS assumes that all of your content is inside the directories people normally put content in, then its design is completely brain-dead or worse, user-hostile.

It is objectively the best-selling, most popular software design ever made.

Are you saying that the OS will someday torpedo any file that isn't in one of the special locations mandated by Apple?

No. I'm saying that those special locations have special properties. If you save a file that isn't in a special location, then nothing will happen to it. What I'm saying is that if you try to change the design or behaviour of one of those special locations, then you are putting yourself at risk of data loss.

That's totally insane, why would anyone design a system like that?

Apple once had a system where you could save a file anywhere you wanted. You could hack pretty much anything on it. If you listen to people today, they'll tell you it was the greatest thing ever, the way Steve intended it, yada, yada, yada. It almost drove Apple into bankruptcy.


Then Apple came out with a system that was much more restrictive. It was more restrictive even than the current design. It made Apple so much money they literally had to start giving it away.

And if that's true, what use is an external drive unless you put your home directory on it?

To store files on? An external volume, or any location that isn't in a protected directory like Documents, Downloads, Desktop, Library, etc. can be used for anything you want. Hack it up to your heart's content. Nothing stopping you. But if you want to hack up a directory that is intimately tied to some syncing software, you are effectively hacking around on the internals of that software. Apple has special provisions to allow more-or-less normal Finder access to folders used by iCloud and 3rd party sync software. But if you deviate from that kind of normal behaviour, and symbolic links are definitely a deviation, then you have no guarantee of data integrity.

From what I see, many users have external drives but they don't move their home directory. How can that extra space be safely used?

As I've said several times already, there is absolutely nothing wrong with moving your home directory. But if OneDrive doesn't work with that, then that's a bug for OneDrive to solve. And if you depend on OneDrive, then you are simply out of options. You can store anything you want on your external drive. Just not anything related to OneDrive, apparently.


The is a user-to-user support forum for Apple products. As far as I'm concerned, you can just turn on iCloud Drive and the problem's solved. Apple offers plans up to 2 TB of cloud storage. You don't need any external drives. But if you want to have some files on an external volume instead of or in addition to iCloud, go right ahead. There's absolutely no problem with that. If you have some 3rd party tool that can't use your external drive, or some sync tool that for some reason needs more space than you have, then that sounds like a problem with the 3rd party tool. That's not a problem that is going to get solved on the Apple forums.

Dec 26, 2022 7:19 PM in response to etresoft

Are you actually saying that a symlink INSIDE a basically empty ~/Documents directory is a dangerous hack? If that's the case then I can just delete it, its only purpose is to save a couple of mouse clicks when navigating from the default location (~/Documents).


Other than that, I don't see that I'm doing anything different than what you yourself are saying is perfectly safe.


Maybe we're just talking past each other.

Dec 26, 2022 8:57 PM in response to Barney-15E

Yup, I know, and I'm doing exactly that. The only reason for the symlink inside ~/Documents was because the default location in the file picker seems to be ~/Documents, and that way I'm only one click away from my "real" Documents folder at app startup. If it's really dangerous to use a symlink I'll just trash it and put up with a few extra mouse clicks, no biggie.


(But it still seems to me very user-hostile for an OS to treat symlinks inside a user's private space in unpredictable ways - I've used symlinks on both Linux and Unix systems for literally decades and this is the first time anyone has told me that they conflict with the developer's intentions.)

Dec 27, 2022 5:49 AM in response to elisatems

You’ve been posting messages for a week talking about NFS servers, moving your home directory while logged in, then corrupting your home directory, then OneDrive not working, and now the solution is simply a symbolic link in your documents folder that I won’t let you do? If that is truly the solution and fixes everything, then go for it. Don’t let me stop you.


There is no requirement that we approve or provide assistance to every, or to any, idea that you may have. I’ve already told you what are the best solutions to your problem:

1) buy a new computer with adequate storage, or

2) stop using buggy 3rd party cloud storage


You are free to reject those solutions but don’t expect any further explanations or help.

Dec 27, 2022 6:36 AM in response to etresoft

In one post, you say that I can store my data on an external drive (perfectly acceptable assuming there is a safe way to access it), in the next you say that I need to buy "a new computer with adequate storage"? Is this supposed to be helpful?


I'm not asking you to "approve" my ideas. You're telling me that things I've done on other Unix systems since the mid '80s are unsafe in MacOS world. Ok, I'm not an Apple aficionado, I'm willing to learn.


I've already said that I can do without the convenience symlink you say is unsafe - is it safe to put an external folder in the sidebar? Set the Finder to open new windows in an external folder? These are perfectly acceptable assuming they won't someday lead to data loss.


And if they are, why do I need to by ANOTHER new computer? That's not an option (this IS a new computer, does Apple accept an exchange? I didn't think so)... nor is not using OneDrive. If it was my choice I would chuck OD in a heartbeat... it is my EMPLOYER'S choice, full stop.

Dec 27, 2022 8:04 AM in response to elisatems

elisatems wrote:

In one post, you say that I can store my data on an external drive (perfectly acceptable assuming there is a safe way to access it), in the next you say that I need to buy "a new computer with adequate storage"? Is this supposed to be helpful?

I've totally lost track of what you are trying to do, and why. You said you wanted to move your home directory to an external drive because "space becoming very tight". Why is that? Have you tried deleting files? Moving big files to that external drive? What's the deal with OneDrive? Is that what is taking up all of your space? Does it not have basic iCloud functionality to only maintain local copies of recent files? I don't know, and I don't care, because it's OneDrive. This is discussions.apple.com, not discussions.microsoft.com.

You're telling me that things I've done on other Unix systems since the mid '80s are unsafe in MacOS world.

A file sync system is simply a distributed database. You will have as much success hacking around on the internals as you would have had hacking around on the internals of a distributed Oracle database in the mid '80s.

I've already said that I can do without the convenience symlink you say is unsafe - is it safe to put an external folder in the sidebar? Set the Finder to open new windows in an external folder? These are perfectly acceptable assuming they won't someday lead to data loss.

As I keep saying, if you have managed to solve your disk space issue, repair your corrupted home directory, and are now confident that you can solve your problem by creating a convenience symbolic link, a sidebar entry, or a Finder setting, then why do you keep asking for my approval? You've got my approval! Do it! Create that link and live the dream.

And if they are, why do I need to by ANOTHER new computer? That's not an option (this IS a new computer, does Apple accept an exchange? I didn't think so)... nor is not using OneDrive. If it was my choice I would chuck OD in a heartbeat... it is my EMPLOYER'S choice, full stop.

Then tell you employer to buy you a new computer with more storage and/or provide technical support to its employees. I don't work for your employer so I have no concerns about your employers dire financial straits or inadequate IT staff.

Dec 27, 2022 9:30 AM in response to etresoft

Somehow I missed this... good grief, why the attitude? As I said, I'm not looking for anyone's *approval*, I just want to find a safe and supported solution to my disk space problem within the constraints imposed by my job. Is that so unusual?


You've given me advice that seems contradictory - on the one hand, you've said that there is no problem offloading user content to the external drive, and on the other you've told me my only safe option is to buy another computer with a larger internal drive. If the first statement is true, how can external data be accessed safely and conveniently from the Finder? And if there is a way, why on earth would I need to buy another new computer?


If you can't offer helpful information but only ridicule ideas for solutions I've asked about, then why reply at all?


Dec 27, 2022 10:23 AM in response to elisatems

elisatems wrote:

I just want to find a safe and supported solution to my disk space problem within the constraints imposed by my job.

You repeatedly refuse to accept safe and supported solutions.

You've given me advice that seems contradictory

No, you keep misrepresenting what I'm saying.

If you can't offer helpful information but only ridicule ideas for solutions I've asked about, then why reply at all?

And if you can't offer anything but insults when people try to help you, then why reply at all?


For the last time.


Do whatever you want.

Dec 27, 2022 2:22 PM in response to etresoft

Ok. Given that all you can offer is snark, I'll accept @Barney-15E's implicit endorsement of putting external folders in the Finder sidebar as a safe solution. I was hoping for a consensus opinion, but apparently that's not going to happen.


A big thank you to @Barney-15E and @BobHarris for helpful replies, probably others as well from earlier in the thread that I've forgotten. Happy holidays to all.

This thread has been closed by the system or the community team. You may vote for any posts you find helpful, or search the Community for additional answers.

Moving home directory

Welcome to Apple Support Community
A forum where Apple customers help each other with their products. Get started with your Apple Account.