Error: Permission denied @ dir_s_mkdir - /usr/local/Cellar Error: Permission denied @ apply2files - /usr/local/bin Error: Permission denied @ dir_s_mkdir - /usr/local/Cellar Error: Permission denied @ apply2files - /usr/local/bin Error: Permission denied @ dir_s_mkdir - /usr/local/Cellar Error: Permission denied @ apply2files - /usr/local/bin # Fix all Homebrew directories sudo chown -R $(whoami) /usr/local/bin /usr/local/etc /usr/local/include /usr/local/lib /usr/local/sbin /usr/local/share /usr/local/var /usr/local/opt /usr/local/Cellar /usr/local/Homebrew # Alternative: Fix just the Homebrew prefix sudo chown -R $(whoami) "$(brew --prefix)"/* # Fix all Homebrew directories sudo chown -R $(whoami) /usr/local/bin /usr/local/etc /usr/local/include /usr/local/lib /usr/local/sbin /usr/local/share /usr/local/var /usr/local/opt /usr/local/Cellar /usr/local/Homebrew # Alternative: Fix just the Homebrew prefix sudo chown -R $(whoami) "$(brew --prefix)"/* # Fix all Homebrew directories sudo chown -R $(whoami) /usr/local/bin /usr/local/etc /usr/local/include /usr/local/lib /usr/local/sbin /usr/local/share /usr/local/var /usr/local/opt /usr/local/Cellar /usr/local/Homebrew # Alternative: Fix just the Homebrew prefix sudo chown -R $(whoami) "$(brew --prefix)"/* # Apple Silicon uses /opt/homebrew sudo chown -R $(whoami) /opt/homebrew/bin /opt/homebrew/etc /opt/homebrew/include /opt/homebrew/lib /opt/homebrew/sbin /opt/homebrew/share /opt/homebrew/var /opt/homebrew/opt /opt/homebrew/Cellar /opt/homebrew/Homebrew # Or use the Homebrew prefix directly sudo chown -R $(whoami) "$(brew --prefix)"/* # Apple Silicon uses /opt/homebrew sudo chown -R $(whoami) /opt/homebrew/bin /opt/homebrew/etc /opt/homebrew/include /opt/homebrew/lib /opt/homebrew/sbin /opt/homebrew/share /opt/homebrew/var /opt/homebrew/opt /opt/homebrew/Cellar /opt/homebrew/Homebrew # Or use the Homebrew prefix directly sudo chown -R $(whoami) "$(brew --prefix)"/* # Apple Silicon uses /opt/homebrew sudo chown -R $(whoami) /opt/homebrew/bin /opt/homebrew/etc /opt/homebrew/include /opt/homebrew/lib /opt/homebrew/sbin /opt/homebrew/share /opt/homebrew/var /opt/homebrew/opt /opt/homebrew/Cellar /opt/homebrew/Homebrew # Or use the Homebrew prefix directly sudo chown -R $(whoami) "$(brew --prefix)"/* Error: Fetching /usr/local/Homebrew/Library/Taps/homebrew/homebrew-core failed! fatal: could not read Username for 'https://github.com': terminal prompts disabled Error: Fetching /usr/local/Homebrew/Library/Taps/homebrew/homebrew-core failed! fatal: could not read Username for 'https://github.com': terminal prompts disabled Error: Fetching /usr/local/Homebrew/Library/Taps/homebrew/homebrew-core failed! fatal: could not read Username for 'https://github.com': terminal prompts disabled # Step 1: Update Homebrew core (run this twice—yes, really) brew update brew update # Step 2: Run diagnostics brew doctor # Step 3: Fix whatever brew doctor reports brew doctor | xargs brew install # If that doesn't work, reset the Homebrew core tap cd "$(brew --repository homebrew/core)" git fetch --unshallow 2>/dev/null || git fetch git reset --hard origin/master brew update # Step 1: Update Homebrew core (run this twice—yes, really) brew update brew update # Step 2: Run diagnostics brew doctor # Step 3: Fix whatever brew doctor reports brew doctor | xargs brew install # If that doesn't work, reset the Homebrew core tap cd "$(brew --repository homebrew/core)" git fetch --unshallow 2>/dev/null || git fetch git reset --hard origin/master brew update # Step 1: Update Homebrew core (run this twice—yes, really) brew update brew update # Step 2: Run diagnostics brew doctor # Step 3: Fix whatever brew doctor reports brew doctor | xargs brew install # If that doesn't work, reset the Homebrew core tap cd "$(brew --repository homebrew/core)" git fetch --unshallow 2>/dev/null || git fetch git reset --hard origin/master brew update which brew # /usr/local/bin/brew ← Wrong! (Intel path on Apple Silicon) brew install node # Error: Cannot install on Intel-only path which brew # /usr/local/bin/brew ← Wrong! (Intel path on Apple Silicon) brew install node # Error: Cannot install on Intel-only path which brew # /usr/local/bin/brew ← Wrong! (Intel path on Apple Silicon) brew install node # Error: Cannot install on Intel-only path # Check your current Homebrew path brew --prefix # Apple Silicon should show: /opt/homebrew # Intel should show: /usr/local # If you're on Apple Silicon but seeing /usr/local, reinstall Homebrew: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # Add to your shell config (~/.zshrc or ~/.bashrc) echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc source ~/.zshrc # Verify which brew # Should output: /opt/homebrew/bin/brew # Check your current Homebrew path brew --prefix # Apple Silicon should show: /opt/homebrew # Intel should show: /usr/local # If you're on Apple Silicon but seeing /usr/local, reinstall Homebrew: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # Add to your shell config (~/.zshrc or ~/.bashrc) echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc source ~/.zshrc # Verify which brew # Should output: /opt/homebrew/bin/brew # Check your current Homebrew path brew --prefix # Apple Silicon should show: /opt/homebrew # Intel should show: /usr/local # If you're on Apple Silicon but seeing /usr/local, reinstall Homebrew: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # Add to your shell config (~/.zshrc or ~/.bashrc) echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc source ~/.zshrc # Verify which brew # Should output: /opt/homebrew/bin/brew # 1. Update Homebrew itself brew update # 2. Check for issues brew doctor # 3. List what needs attention brew missing # 4. Fix permission issues (Intel) sudo chown -R $(whoami) /usr/local/{bin,etc,include,lib,sbin,share,var,opt,Cellar,Homebrew} # OR fix permission issues (Apple Silicon) sudo chown -R $(whoami) /opt/homebrew/{bin,etc,include,lib,sbin,share,var,opt,Cellar,Homebrew} # 5. Remove old versions brew cleanup # 6. Check for broken packages brew doctor # 7. Reinstall anything broken brew missing | xargs brew install # 1. Update Homebrew itself brew update # 2. Check for issues brew doctor # 3. List what needs attention brew missing # 4. Fix permission issues (Intel) sudo chown -R $(whoami) /usr/local/{bin,etc,include,lib,sbin,share,var,opt,Cellar,Homebrew} # OR fix permission issues (Apple Silicon) sudo chown -R $(whoami) /opt/homebrew/{bin,etc,include,lib,sbin,share,var,opt,Cellar,Homebrew} # 5. Remove old versions brew cleanup # 6. Check for broken packages brew doctor # 7. Reinstall anything broken brew missing | xargs brew install # 1. Update Homebrew itself brew update # 2. Check for issues brew doctor # 3. List what needs attention brew missing # 4. Fix permission issues (Intel) sudo chown -R $(whoami) /usr/local/{bin,etc,include,lib,sbin,share,var,opt,Cellar,Homebrew} # OR fix permission issues (Apple Silicon) sudo chown -R $(whoami) /opt/homebrew/{bin,etc,include,lib,sbin,share,var,opt,Cellar,Homebrew} # 5. Remove old versions brew cleanup # 6. Check for broken packages brew doctor # 7. Reinstall anything broken brew missing | xargs brew install # Full repair sequence sudo chown -R $(whoami) "$(brew --prefix)"/* brew update-reset brew update brew doctor brew upgrade # If Xcode Command Line Tools are broken xcode-select --install # Or reset them: sudo xcode-select --reset sudo xcode-select --install # Full repair sequence sudo chown -R $(whoami) "$(brew --prefix)"/* brew update-reset brew update brew doctor brew upgrade # If Xcode Command Line Tools are broken xcode-select --install # Or reset them: sudo xcode-select --reset sudo xcode-select --install # Full repair sequence sudo chown -R $(whoami) "$(brew --prefix)"/* brew update-reset brew update brew doctor brew upgrade # If Xcode Command Line Tools are broken xcode-select --install # Or reset them: sudo xcode-select --reset sudo xcode-select --install # Create a homebrew group sudo dscl . create /Groups/homebrew sudo dscl . create /Groups/homebrew PrimaryGroupID 500 # Add users to the group sudo dscl . append /Groups/homebrew GroupMembership user1 sudo dscl . append /Groups/homebrew GroupMembership user2 # Set group ownership sudo chgrp -R homebrew "$(brew --prefix)" sudo chmod -R g+w "$(brew --prefix)" # Each user runs this once: echo 'export HOMEBREW_BREW_FILE_CHECKDIR_VERBOSE=1' >> ~/.zshrc # Create a homebrew group sudo dscl . create /Groups/homebrew sudo dscl . create /Groups/homebrew PrimaryGroupID 500 # Add users to the group sudo dscl . append /Groups/homebrew GroupMembership user1 sudo dscl . append /Groups/homebrew GroupMembership user2 # Set group ownership sudo chgrp -R homebrew "$(brew --prefix)" sudo chmod -R g+w "$(brew --prefix)" # Each user runs this once: echo 'export HOMEBREW_BREW_FILE_CHECKDIR_VERBOSE=1' >> ~/.zshrc # Create a homebrew group sudo dscl . create /Groups/homebrew sudo dscl . create /Groups/homebrew PrimaryGroupID 500 # Add users to the group sudo dscl . append /Groups/homebrew GroupMembership user1 sudo dscl . append /Groups/homebrew GroupMembership user2 # Set group ownership sudo chgrp -R homebrew "$(brew --prefix)" sudo chmod -R g+w "$(brew --prefix)" # Each user runs this once: echo 'export HOMEBREW_BREW_FILE_CHECKDIR_VERBOSE=1' >> ~/.zshrc # .github/workflows/test.yml jobs: test: runs-on: macos-latest steps: - name: Fix Homebrew permissions run: | sudo chown -R $(whoami) "$(brew --prefix)"/* # Note: GitHub Actions usually has correct permissions # Only needed for self-hosted runners - name: Install dependencies run: | brew update brew install node@20 [email protected] # .github/workflows/test.yml jobs: test: runs-on: macos-latest steps: - name: Fix Homebrew permissions run: | sudo chown -R $(whoami) "$(brew --prefix)"/* # Note: GitHub Actions usually has correct permissions # Only needed for self-hosted runners - name: Install dependencies run: | brew update brew install node@20 [email protected] # .github/workflows/test.yml jobs: test: runs-on: macos-latest steps: - name: Fix Homebrew permissions run: | sudo chown -R $(whoami) "$(brew --prefix)"/* # Note: GitHub Actions usually has correct permissions # Only needed for self-hosted runners - name: Install dependencies run: | brew update brew install node@20 [email protected] # As root on the runner sudo chown -R runner:runner "$(brew --prefix)"/* # As root on the runner sudo chown -R runner:runner "$(brew --prefix)"/* # As root on the runner sudo chown -R runner:runner "$(brew --prefix)"/* # ❌ NEVER do this sudo brew install something # ✅ Always use regular user brew install something # ❌ NEVER do this sudo brew install something # ✅ Always use regular user brew install something # ❌ NEVER do this sudo brew install something # ✅ Always use regular user brew install something # After every macOS update brew update && brew doctor && brew upgrade # After every macOS update brew update && brew doctor && brew upgrade # After every macOS update brew update && brew doctor && brew upgrade # Brewfile tap "homebrew/core" tap "homebrew/cask" # Development brew "git" brew "node" brew "[email protected]" brew "terraform" # Applications cask "visual-studio-code" cask "docker" cask "rectangle" # Mas apps (Mac App Store) mas "Xcode", id: 497799835 # Brewfile tap "homebrew/core" tap "homebrew/cask" # Development brew "git" brew "node" brew "[email protected]" brew "terraform" # Applications cask "visual-studio-code" cask "docker" cask "rectangle" # Mas apps (Mac App Store) mas "Xcode", id: 497799835 # Brewfile tap "homebrew/core" tap "homebrew/cask" # Development brew "git" brew "node" brew "[email protected]" brew "terraform" # Applications cask "visual-studio-code" cask "docker" cask "rectangle" # Mas apps (Mac App Store) mas "Xcode", id: 497799835 # Install everything brew bundle install # Restore after disaster brew bundle install --file=Brewfile # Install everything brew bundle install # Restore after disaster brew bundle install --file=Brewfile # Install everything brew bundle install # Restore after disaster brew bundle install --file=Brewfile # ~/.zshrc or ~/.bashrc # Apple Silicon Homebrew path if [[ -d /opt/homebrew/bin ]]; then eval "$(/opt/homebrew/bin/brew shellenv)" fi # Intel Homebrew path (for older Macs or Rosetta) if [[ -d /usr/local/bin && ! -d /opt/homebrew/bin ]]; then eval "$(/usr/local/bin/brew shellenv)" fi # ~/.zshrc or ~/.bashrc # Apple Silicon Homebrew path if [[ -d /opt/homebrew/bin ]]; then eval "$(/opt/homebrew/bin/brew shellenv)" fi # Intel Homebrew path (for older Macs or Rosetta) if [[ -d /usr/local/bin && ! -d /opt/homebrew/bin ]]; then eval "$(/usr/local/bin/brew shellenv)" fi # ~/.zshrc or ~/.bashrc # Apple Silicon Homebrew path if [[ -d /opt/homebrew/bin ]]; then eval "$(/opt/homebrew/bin/brew shellenv)" fi # Intel Homebrew path (for older Macs or Rosetta) if [[ -d /usr/local/bin && ! -d /opt/homebrew/bin ]]; then eval "$(/usr/local/bin/brew shellenv)" fi # Export your installed packages brew bundle dump --file=/tmp/Brewfile # Uninstall Homebrew /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)" # Reinstall Homebrew /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # Restore your packages brew bundle install --file=/tmp/Brewfile # Export your installed packages brew bundle dump --file=/tmp/Brewfile # Uninstall Homebrew /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)" # Reinstall Homebrew /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # Restore your packages brew bundle install --file=/tmp/Brewfile # Export your installed packages brew bundle dump --file=/tmp/Brewfile # Uninstall Homebrew /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)" # Reinstall Homebrew /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # Restore your packages brew bundle install --file=/tmp/Brewfile brew --prefix # /opt/homebrew → Apple Silicon (correct) # /usr/local → Intel (correct on Intel Macs, wrong on Apple Silicon) brew --prefix # /opt/homebrew → Apple Silicon (correct) # /usr/local → Intel (correct on Intel Macs, wrong on Apple Silicon) brew --prefix # /opt/homebrew → Apple Silicon (correct) # /usr/local → Intel (correct on Intel Macs, wrong on Apple Silicon) arch # arm64 → Apple Silicon # i386 → Intel (or Rosetta) # Check which architecture brew is running as file $(which brew) arch # arm64 → Apple Silicon # i386 → Intel (or Rosetta) # Check which architecture brew is running as file $(which brew) arch # arm64 → Apple Silicon # i386 → Intel (or Rosetta) # Check which architecture brew is running as file $(which brew) # Check if it's stuck brew config | grep -E "HOMEBREW_BOTTLE_DOMAIN|HOMEBREW_API_DOMAIN" # Use faster mirrors (optional) export HOMEBREW_BOTTLE_DOMAIN=https://ghcr.io/v2/homebrew/core export HOMEBREW_API_DOMAIN=https://formulae.brew.sh/api # Add to ~/.zshrc for persistence echo 'export HOMEBREW_BOTTLE_DOMAIN=https://ghcr.io/v2/homebrew/core' >> ~/.zshrc # Check if it's stuck brew config | grep -E "HOMEBREW_BOTTLE_DOMAIN|HOMEBREW_API_DOMAIN" # Use faster mirrors (optional) export HOMEBREW_BOTTLE_DOMAIN=https://ghcr.io/v2/homebrew/core export HOMEBREW_API_DOMAIN=https://formulae.brew.sh/api # Add to ~/.zshrc for persistence echo 'export HOMEBREW_BOTTLE_DOMAIN=https://ghcr.io/v2/homebrew/core' >> ~/.zshrc # Check if it's stuck brew config | grep -E "HOMEBREW_BOTTLE_DOMAIN|HOMEBREW_API_DOMAIN" # Use faster mirrors (optional) export HOMEBREW_BOTTLE_DOMAIN=https://ghcr.io/v2/homebrew/core export HOMEBREW_API_DOMAIN=https://formulae.brew.sh/api # Add to ~/.zshrc for persistence echo 'export HOMEBREW_BOTTLE_DOMAIN=https://ghcr.io/v2/homebrew/core' >> ~/.zshrc # ✅ Fix permissions (copy-paste the right one for your Mac) # Apple Silicon: sudo chown -R $(whoami) /opt/homebrew/{bin,etc,include,lib,sbin,share,var,opt,Cellar,Homebrew} # Intel: sudo chown -R $(whoami) /usr/local/{bin,etc,include,lib,sbin,share,var,opt,Cellar,Homebrew} # ✅ Update Homebrew brew update && brew update # ✅ Diagnose issues brew doctor # ✅ Fix reported issues brew doctor | grep -E "Error|Warning" | xargs -I {} sh -c 'echo "Fix: {}"' # ✅ Clean up old versions brew cleanup # ✅ Verify everything works brew --version brew config # ✅ Fix permissions (copy-paste the right one for your Mac) # Apple Silicon: sudo chown -R $(whoami) /opt/homebrew/{bin,etc,include,lib,sbin,share,var,opt,Cellar,Homebrew} # Intel: sudo chown -R $(whoami) /usr/local/{bin,etc,include,lib,sbin,share,var,opt,Cellar,Homebrew} # ✅ Update Homebrew brew update && brew update # ✅ Diagnose issues brew doctor # ✅ Fix reported issues brew doctor | grep -E "Error|Warning" | xargs -I {} sh -c 'echo "Fix: {}"' # ✅ Clean up old versions brew cleanup # ✅ Verify everything works brew --version brew config # ✅ Fix permissions (copy-paste the right one for your Mac) # Apple Silicon: sudo chown -R $(whoami) /opt/homebrew/{bin,etc,include,lib,sbin,share,var,opt,Cellar,Homebrew} # Intel: sudo chown -R $(whoami) /usr/local/{bin,etc,include,lib,sbin,share,var,opt,Cellar,Homebrew} # ✅ Update Homebrew brew update && brew update # ✅ Diagnose issues brew doctor # ✅ Fix reported issues brew doctor | grep -E "Error|Warning" | xargs -I {} sh -c 'echo "Fix: {}"' # ✅ Clean up old versions brew cleanup # ✅ Verify everything works brew --version brew config - Permission resets: macOS updates often reset /usr/local or /opt/homebrew permissions to root:wheel - Path confusion: Apple Silicon Macs use a different Homebrew location than Intel Macs - Xcode Command Line Tools: Updates can break or reset the tools Homebrew depends on - Unfinished installations: A Ctrl+C at the wrong time leaves orphaned locks and partial files - "Your Homebrew is not at the correct location" → Only worry if brew --prefix is wrong - "Some kegs are not linked" → Fine for version managers (nvm, pyenv) - "Unbrewed files in /usr/local" → Normal for some CLI tools - brew install formula → CLI tools, libraries, languages (installed to $(brew --prefix)) - brew install --cask app → macOS applications (installed to /Applications) - brew install --formula node → Explicit formula install - brew install node → Auto-detects (formula for node) - Larger package ecosystem - Better integration with development tools - Simpler binary packages (no long compiles) - Active maintenance and community - sudo chown -R $(whoami) "$(brew --prefix)"/* — Fix permissions - brew update (run twice) — Synchronize taps - brew doctor — Diagnose everything - brew cleanup — Remove old versions - [ ] Run brew doctor right now and fix any errors - [ ] Check your Homebrew path matches your Mac architecture - [ ] Create a Brewfile for easy restores - [ ] Add Homebrew path setup to your shell config