Software⏱️ 3 min read📅 2026-06-11

How to Fix: HomeBrew error message OSX

Brew permission error on OSX

Quick Answer: Change ownership and permissions of /usr/local/share/man/man5 directory to resolve Brew error.

The error message 'The following directories are not writable by your user' appears when you attempt to update or install new formulas using HomeBrew on OSX. This issue specifically affects users who have installed HomeBrew, and it can be frustrating as it prevents the normal functioning of the software.

Resolving this error requires a deeper understanding of file permissions and ownership. By addressing the root cause and making necessary adjustments, you can resolve the problem and continue using HomeBrew without interruptions.

⚠️ Common Causes

  • The primary reason for this error is that the /usr/local/share/man/man5 directory does not have the correct file permissions set for your user. This directory is used to store manual pages, which are part of the Unix standard library.
  • An alternative explanation could be that there's an issue with the HomeBrew installation process or a misconfiguration in the system. However, this is less likely and requires further investigation.

🛠️ Step-by-Step Verified Fixes

Resolving File Permission Issues

  1. Step 1: To resolve file permission issues, you need to change the ownership of the /usr/local/share/man/man5 directory to your user. You can do this by running the following command in the Terminal: `sudo chown -R $(whoami) /usr/local/share/man/man5`. This will set the ownership of the directory to your current user.
  2. Step 2: After changing the ownership, you also need to ensure that your user has write permission for the directory. You can do this by running the following command: `chmod u+w /usr/local/share/man/man5`. This will grant your user the necessary permissions to modify files in the directory.

Alternative Fix (Optional)

  1. Step 1: If you're unable to resolve the issue using the above steps, an alternative approach is to reinstall HomeBrew. You can do this by running `brew uninstall` followed by `brew install`. This will remove and then re-install HomeBrew, potentially resolving any issues with file permissions or configuration.

🎯 Final Words

By understanding the root cause of the error and taking the necessary steps to resolve it, you should be able to fix the issue and continue using HomeBrew without interruptions. Remember to always double-check your work and verify that file permissions are set correctly to avoid similar issues in the future.

Did this fix your problem?

If not, try searching for specific error codes.

🔍 Search Error Database

❓ Frequently Asked Questions