FAQ

자주 묻는 질문

설치 전후로 가장 많이 묻는 내용 — Brewwery가 무엇인지, Homebrew를 어떻게 실행하는지, 그리고 절대 하지 않는 일.

Brewwery 소개

Brewwery는 무엇인가요?

Brewwery는 Homebrew에 그래픽 인터페이스를 제공하는 네이티브 macOS 앱입니다. 설치된 formula와 cask, 검색, 업데이트, tap, 서비스, 정리, 진단, Brewfile, 로컬 작업 기록이 한 창에 모여 있고, 모든 동작은 터미널에서 직접 입력하는 것과 같은 brew 명령을 실행합니다.

Brewwery는 무료인가요?

네. Brewwery는 MIT 라이선스의 무료 오픈소스입니다. 유료 등급, 구독, 계정, 추가 판매가 없으며 전체 소스 코드는 GitHub에 공개되어 있습니다.

Homebrew 공식 앱인가요?

아닙니다. Brewwery는 Homebrew를 사용하는 독립적인 오픈소스 프로젝트입니다. Homebrew 프로젝트와 제휴하거나 승인을 받은 관계가 아니며, 패키지 작업은 여전히 Homebrew가 직접 수행합니다.

Homebrew가 설치되어 있어야 하나요?

네. Brewwery는 이미 설치된 Homebrew를 위한 인터페이스이므로 brew.sh에서 Homebrew를 먼저 설치하세요. Brewwery는 /opt/homebrew/bin/brew, /usr/local/bin/brew, PATH의 brew를 자동으로 찾고, 찾지 못하면 설치 방법을 안내합니다.

설치와 업데이트

어떤 Mac에서 실행되나요?

macOS 14 Sonoma 이상을 실행하는 모든 Mac입니다. Brewwery는 유니버설 앱이라 Apple Silicon과 Intel에서 모두 네이티브로 동작하며, Homebrew가 /opt/homebrew에 있든 /usr/local에 있든 사용할 수 있습니다.

어떻게 설치하나요?

디스크 이미지를 내려받아 열고 Brewwery를 응용 프로그램 폴더로 끌어다 놓으세요. 그다음 응용 프로그램이나 Spotlight에서 실행하면 됩니다. 브라우저 엔진이나 런타임을 포함하지 않아 다운로드 용량은 약 6 MB입니다.

앱이 서명·공증되어 있나요?

네. Brewwery 1.0은 Apple Developer ID로 서명되고 Apple의 공증을 받았기 때문에 다른 Mac 앱처럼 바로 열립니다. 마우스 오른쪽 버튼으로 «열기»를 누르거나 Gatekeeper 설정을 바꿀 필요가 없습니다.

앱 업데이트는 어떻게 되나요?

Mac 앱에서 널리 쓰이는 업데이트 프레임워크 Sparkle을 사용합니다. Brewwery는 백그라운드에서 새 버전을 확인하고, 설치 전에 Apple의 코드 서명과 자체 EdDSA 서명을 모두 검증합니다. 자동 확인 해제, 사전 릴리스 참여, 수동 확인은 설정에서 할 수 있습니다.

0.9를 쓰고 있습니다. 1.0으로 어떻게 넘어가나요?

1.0을 내려받아 응용 프로그램 폴더의 기존 앱을 교체하세요. 0.9에는 업데이트 기능이 없어 스스로 갱신하지 못합니다. Homebrew 설치는 그대로지만, 네이티브 앱은 저장 방식이 달라 0.9의 설정·즐겨찾기·기록은 이어지지 않습니다.

어떻게 삭제하나요?

Brewwery를 종료하고 앱을 휴지통으로 옮긴 뒤 `rm -rf ~/Library/Application\ Support/Brewwery`와 `defaults delete com.brewwery.app`으로 데이터를 지우세요. Homebrew와 그것으로 설치한 것들은 그대로 남습니다.

사용 방법

패키지를 설치하고 삭제할 수 있나요?

네, formula와 cask 모두 가능합니다. Brewwery는 실행할 명령을 정확히 보여주고 확인을 요청하며, 실행 중에는 Homebrew 출력을 실시간으로 보여 주고, 언제든 취소할 수 있으며, 전체 출력과 함께 기록에 남깁니다.

tap과 서비스도 관리하나요?

네. Tap 페이지는 설치된 tap을 보여주고 owner/repository 형식으로 확인 후 추가·삭제합니다. 서비스 페이지는 Homebrew 서비스를 상태·사용자·파일과 함께 나열하고 시작, 중지, 재시작을 지원합니다.

터미널과 함께 사용해도 되나요?

됩니다. 둘 다 같은 Homebrew 설치를 사용하며, Brewwery는 자체적인 설정을 더하지 않습니다. 터미널에서 무언가를 변경한 뒤에는 Brewwery에서 ⌘R을 눌러 현재 페이지를 새로 고치세요.

Homebrew가 다른 위치에 있는데 동작하나요?

동작합니다. 설정에서 brew 실행 파일 경로를 입력하세요. Brewwery는 절대 경로인지, 실행 가능한 파일인지, `brew --version`에 응답하는지 확인한 뒤 저장하고 모든 명령에 그 경로를 사용합니다.

Brewfile을 지원하나요?

네. `brew bundle dump`로 현재 구성을 내보내고, 어떤 Brewfile이든 읽어 이 Mac과 비교합니다. 이미 설치된 것, 빠진 것, Brewwery가 건너뛰는 것을 나눠 보여 주고, 빠진 tap, formula, cask만 설치합니다. 이를 위해 Brewwery가 검증된 이름만 담은 자체 목록을 작성하므로, 누군가 보낸 Brewfile의 Ruby 코드를 Homebrew가 실행하는 일은 없습니다.

설치가 실패하거나 멈추면 어떻게 되나요?

진행 패널에 Homebrew의 전체 출력이 그대로 남고, 같은 내용이 기록에도 저장됩니다. «취소»는 Homebrew와 그것이 시작한 다운로드 등 모든 프로세스를 중단합니다. 작업마다 안전 제한 시간도 있습니다. 설치와 업그레이드는 45분, 삭제는 15분, 정리는 30분, 서비스는 5분입니다. «Report this failure»를 누르면 출력이 채워진 GitHub 이슈나 이메일이 열립니다. 내용을 확인한 뒤 직접 보내면 됩니다.

보안과 개인정보

임의의 셸 명령을 실행하나요?

아니요. Brewwery는 셸을 실행하지 않습니다. 타입이 정해진 닫힌 명령 집합에서 brew를 직접 실행하며, 패키지·cask·tap·서비스 이름은 인자가 되기 전에 엄격한 문자 규칙으로 검증됩니다. 다른 것을 실행하게 만들 방법은 없습니다.

데이터를 수집하나요?

아니요. 텔레메트리, 분석, 크래시 리포트, 계정, 클라우드 동기화가 전혀 없습니다. 설정·즐겨찾기·기록은 Mac에만 저장되고, 실행하는 명령에는 HOMEBREW_NO_ANALYTICS=1을 설정합니다. 앱 자체의 네트워크 요청은 업데이트 확인뿐입니다.

비밀번호나 sudo가 필요한가요?

필요 없습니다. 모든 명령은 터미널에서 직접 입력할 때와 똑같이 사용자 권한으로 실행됩니다. 헬퍼 도구도, 상승된 권한도 없고 관리자 권한을 요구하지도 않습니다.

Homebrew 설치가 망가질 수도 있나요?

표준 Homebrew 명령만, 한 번에 하나씩 실행하며, 무언가를 바꾸는 명령은 실행 전에 어떤 명령인지 보여 주고 확인을 받습니다. 정리는 미리보기를 먼저 거쳐야 합니다. 백그라운드에서는 아무것도 바꾸지 않고, 업데이트 확인은 오래된 패키지 목록만 읽습니다.

왜 Brewwery인가

CLI가 있는데 왜 GUI를 쓰나요?

기억해 내는 것보다 보는 편이 빠르기 때문입니다. 무엇이 설치되어 있고, 무엇이 오래되었고, 무엇이 무엇에 의존하며, 어떤 서비스가 돌아가고, 정리로 얼마를 확보할 수 있는지를 명령을 조합하거나 출력을 훑지 않고 알 수 있습니다. 터미널로 하고 싶다면 명령 페이지에서 대응하는 brew 명령을 확인하세요.

이전 Electron 버전과 무엇이 다른가요?

0.9.7까지의 Brewwery는 React 화면과 Rust 코어를 쓰는 Electron 앱이었습니다. 1.0은 Swift와 SwiftUI, AppKit으로 처음부터 다시 만들었습니다. 기능은 같지만 다운로드 용량과 메모리 사용량이 크게 줄었고, 스크롤과 키보드 동작이 네이티브이며, Apple Silicon과 Intel용으로 서명·공증되고 자동 업데이트를 지원합니다.

Linux나 Windows 버전이 있나요?

없습니다. Brewwery는 Apple 프레임워크로 만든 네이티브 Mac 앱이며 이식 계획도 없습니다. Linux의 Homebrew는 명령줄에서 잘 동작합니다.

더 궁금한 점이 있나요?

문서에서 설치, 모든 기능, 보안 모델, 문제 해결을 다룹니다. 그 밖의 내용은 편하게 문의해 주세요.