지니제스트 테크 블로그 배너
지니제스트Tech Archive
MacOS6분 소요

macOS Homebrew Permission denied와 brew doctor 경고 해결

•
지지니제스트

brew install이나 cleanup에서 Permission denied가 날 때 brew doctor가 알려 주는 쓰기 불가 디렉터리를 chown으로 되돌리는 방법, sudo를 쓰면 안 되는 이유, Apple Silicon의 brew: command not found까지 정리했습니다.

macOS Homebrew Permission denied와 brew doctor 경고 해결

brew upgrade나 brew cleanup 도중 Permission denied @ dir_s_mkdir가 나오면 습관적으로 sudo brew ...를 붙이고 싶어집니다. 하지만 그렇게 하면 파일 소유자가 root로 바뀌어 다음 번 일반 계정 실행이 다시 막힙니다. 원인은 대개 이미 root 소유로 바뀐 Homebrew 디렉터리입니다. 어떤 디렉터리가 문제인지는 brew doctor가 알려 주고, 고치는 방법은 소유권을 현재 계정으로 되돌리는 것입니다.

brew doctor로 쓰기 불가 디렉터리를 찾아 chown과 chmod로 되돌리고 brew doctor로 다시 확인하는 순서
권한 오류를 푸는 순서


오류가 이렇게 보입니다

TEXT
Error: Permission denied @ dir_s_mkdir - /opt/homebrew/var/homebrew/locks
Error: Permission denied @ apply2files - /opt/homebrew/share/man/man1/example.1

경로의 /opt/homebrew는 Apple Silicon Mac의 기본 prefix이고, Intel Mac은 /usr/local입니다. 어느 쪽이든 현재 계정이 해당 경로에 쓸 수 없다는 뜻이므로, 먼저 어떤 디렉터리가 문제인지 brew doctor로 확인합니다.

BASH
brew doctor

쓰기 권한 문제가 있다면 아래처럼 해당 디렉터리 목록과 해결 명령을 직접 알려 줍니다. 출력 형식은 버전마다 조금씩 다르며, 아래는 형식을 설명하기 위한 예시입니다.

TEXT
Warning: The following directories are not writable by your user:
/opt/homebrew/share/man/man1

You should change the ownership of these directories to your user.
  sudo chown -R $(whoami) /opt/homebrew/share/man/man1

And make sure that your user has write permission.
  chmod u+w /opt/homebrew/share/man/man1

왜 소유권이 root로 바뀌었나

Homebrew는 설치 스크립트를 제외하면 일반 사용자 권한으로 실행하도록 만들어졌습니다. 소유권이 틀어지는 이유는 보통 셋 중 하나입니다.

  • 예전에 sudo brew install 같은 명령을 실행해 root 소유 파일이 생겼습니다.
  • Time Machine이나 이전 도구로 Mac을 옮기면서 사용자 UID가 달라졌습니다.
  • 다른 설치 스크립트가 prefix 아래의 소유권을 임의로 바꿨습니다.

소유권 되돌리기

가장 안전한 방법은 brew doctor가 알려 준 디렉터리만 고치는 것입니다. 한꺼번에 처리하고 싶다면 Homebrew prefix 아래로 범위를 한정합니다.

BASH
sudo chown -R "$(whoami)" "$(brew --prefix)"/*
chmod -R u+w "$(brew --prefix)"/*

/opt나 /usr/local 전체에 chown -R을 거는 것은 피하세요. Intel Mac의 /usr/local에는 Homebrew가 아닌 파일도 있어서 다른 프로그램이 망가질 수 있습니다. 그래서 brew --prefix 아래로만 제한합니다.

처리한 뒤 brew doctor를 다시 실행해 경고가 사라졌는지 확인합니다.

BASH
brew doctor
brew cleanup

Your system is ready to brew.가 나오면 끝입니다. 경고가 남아 있다면 메시지에 적힌 다음 항목을 하나씩 처리하세요. 모든 경고가 치명적인 것은 아니지만, 쓰기 권한과 링크가 깨졌다는 경고는 해결해 두는 편이 낫습니다.


brew: command not found

설치는 됐는데 brew를 찾지 못한다면 PATH에 prefix가 빠진 것입니다. Apple Silicon Mac에서는 셸 프로필에 shellenv를 추가합니다.

BASH
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

~/.zprofile은 로그인 셸에서 한 번 읽히므로 PATH 설정을 넣기에 알맞습니다. 이미 PATH 순서가 꼬여 있다면 macOS zsh 환경변수 PATH 중복과 순서 꼬임 해결도 같이 보세요.


그래도 Operation not permitted가 나온다면

Permission denied가 아니라 Operation not permitted가 나온다면 소유권이 아니라 macOS의 개인정보 보호 권한 문제일 수 있습니다. 터미널 앱에 파일 접근 권한이 없는 경우이며, 이때는 macOS 터미널 Operation not permitted 해결에서 설정 위치를 확인하세요.


재발 방지

  • sudo brew ...를 실행하지 않습니다. 권한 문제가 나면 sudo를 붙이는 대신 brew doctor를 봅니다.
  • 설치는 공식 스크립트를 쓰고, 설치 중 나오는 안내를 읽습니다.
  • Mac을 이전한 뒤에는 brew doctor를 한 번 실행해 소유권 경고가 없는지 봅니다.
BASH
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

자주 묻는 질문

sudo brew를 쓰면 왜 안 되나요

sudo로 실행하면 새로 만들어지는 락 파일과 캐시, 링크의 소유자가 root가 됩니다. 이후 일반 계정으로 brew update나 upgrade를 하면 그 파일들에 접근하지 못해 같은 오류가 반복됩니다.

/opt/homebrew 전체에 chown을 해도 되나요

됩니다. /opt/homebrew는 Homebrew 전용 디렉터리입니다. 문제는 /opt나 /usr/local처럼 더 넓은 경로에 재귀 적용하는 경우입니다.

brew doctor 경고를 무시해도 되나요

모든 경고가 설치를 막지는 않습니다. 하지만 쓰기 권한이나 링크가 깨졌다는 경고를 두면 업그레이드 중 실패하거나 바이너리가 덮어써지지 않는 문제로 이어질 수 있어 해결해 두는 편이 안전합니다.


참고 자료