How do I fix Homebrew permissions on Mac without breaking ownership?

[Olivia.P]

I’m trying to set up a local development environment on my new Mac, and I keep hitting a wall with Homebrew permissions. Every time I run a basic install command, I get errors about directories not being writable, even after using sudo, which feels wrong. I’m worried I’ve messed up the ownership somewhere along the way and don’t know the cleanest fix.

[Aaron.L]

Yeah I ran into that too on a new Mac. The error kept saying folders weren’t writable even with sudo. I checked who owned /usr/local (or /opt/homebrew on Apple Silicon) and it turned out to be root. I did a quick chown -R $(whoami) /usr/local and tried again. It mostly cleared the wall, though a few background processes still threw a hiccup here and there.

[James75]

I wonder if the real issue isn’t just permissions. In my case I found a stray root-owned file in the brew tree and fixing that alone didn't fix the write errors until I aligned the parent directory's ownership too.

[Jack.R]

Have you checked exactly which directory the error mentions? Sometimes it's a subdir like Cellar rather than the root, and that changes what you need to fix?

[Kenneth.L]

I tried staying away from sudo and kept hoping it was a temporary glitch. Then I paused, reconsidered, and ended up backing out of a quick fix I started and re-evaluated later. It didn't feel like a clean solution, but the tension faded after I stopped chasing it for a day.