How do i fix macOS Homebrew permission errors when linking?

[Zachary.R]

I’m trying to set up a local development environment on my Mac using Homebrew, but I keep running into permission errors when I try to link packages. I followed the official documentation for the brew link command, but it still fails saying it can’t write to /usr/local. Has anyone else hit this recently after a macOS update?

[Jeffrey_J]

Yep, this started after a macOS update for me too. /usr/local wasn't writable. I fixed it by changing ownership back to my user: sudo chown -R $(whoami):admin /usr/local and then ran brew link --overwrite. After that the errors went away.

[RyanHM]

I spent a couple of days chasing it and almost blamed the update. It felt like a permissions drift more than a misread docs thing. The mix of sudo prompts and non writable dirs made me doubt the path is the real issue.

[Paisley.T]

Are you on Intel or Apple Silicon, and is /usr/local writable by your user? If the permissions are locked down by the system, that can bite you even when you followed the docs.

[GaryS]

I once wandered into a stale symlink in /usr/local/bin that pointed at something that no longer existed. Removed the broken link and reran the install, and the linker finally moved on, but it was a detour I didn't expect.