対象読者: Homebrewを脳死でコピペして使っている人
提供価値: 様々なツールのインストールが怖く無くなる
※ 本記事はmacOSを対象としたものになります。
Homebrew?とにかくコピペしてきました。
gitやpyenvをインストールするとき、下記コマンドを実行します。
$ brew install git
$ brew install pyenv
このbrewコマンドは、Homebrewというパッケージマネージャーを操作するコマンドですが、初学者にとっては謎のコマンドです。
そこで、本記事ではこの謎のコマンドbrewについて詳しく見ていきたいと思います。
Homebrewとは
Homebrewは、macOS・Linux・WSLで使用されているパッケージマネージャーです(主にはmacOSで使用されている)。
パッケージマネージャーは主に次の操作を管理するツールです。
- 検索
- インストール
- 更新
- アンインストール
- 依存関係の解消
そもそもパッケージとは?
パッケージとは、ソフトウェア本体や、そのソフトウェアをインストールするための情報をひとまとめにしたものです。
ソフトウェアを動かすには、実行ファイルだけでなく、次のようにものも必要になります。
- ライブラリ
- 設定ファイル
- 関連コマンド
- バージョン情報
- 他のソフトウェアとの依存関係
Homebrewはこれらをパッケージ単位で管理してくれます。
Homebrewを使わずにインストールするとどうなるか?
次の操作が必要です。
- ソフトウェアの公式サイトを探す
- Macに対応したファイルを選ぶ
- CPUやOSに合うバージョンを選ぶ
- ファイルをダウンロードする
- 展開またはビルドする
- 適切な場所へ配置する
- 必要に応じてPATHを設定する
- 更新時には新しいバージョンを再度取得する
これらの操作を簡単にしてくれるのがHomebrewです。
FormulaとCaskとは
Homebrewでは、インストールするものを大きく2種類に分けています。
- Formula: 主にターミナルで使うコマンドや開発ツール
- Cask: 主にアイコンをクリックして起動するMacアプリ
| 種類 | 何を入れるものか | 例 | コマンド |
|---|---|---|---|
| Formula | CLIツール、言語、DB、ライブラリ | Git,Node.js,PostgreSQL | brew install |
| Cask | .app形式のMacアプリなど | Chrome, VS Code, iTerm2 | brew install --cask |
Homebrewの公式マニュアルでは、Formulaは主にソースから構築されるパッケージ、Caskは開発元によるビルド済みバイナリなどと説明されている。
Homebrewはインストールしたファイルをどう管理するのか
Apple Silicon Mac、でHomebrewを使ってwgetをインストールしたとします。
brew install wget
実際のファイルは、次のようなディレクトリへ保存されます。
/opt/homebrew/Cellar/wget/バージョン番号/
/opt/homebrew/ # Homebrewのインストール先
├── bin/ # Pathを通すディレクトリ
│ └── wget # 実体へのシンボリック
└── Cellar/ # Formulaの実体を保存する場所
└── wget/
└── 1.25.0/ # wgetのバージョン
└── bin/
└── wget # wgetの実体
Cellarは、Formulaでインストールしたパッケージ本体をバージョン別に管理する場所です。
Pathを通すのはopt/homebrew/binで、そこに実体へのシンボリックを置きます。
/opt/homebrew/bin/wget
│
│ シンボリックリンク
▼
/opt/homebrew/Cellar/wget/1.25.0/bin/wget
このようにすることで、実体をバージョン別に整理しながら、利用者は単に次のように実行できます。
$ wget
Bottleとは
Formulaと一緒によく登場するのがBottleです。
Bottleとは、あらかじめビルドされたパッケージです。
ソースコードからソフトウェアを作るにはコンパイルが必要です。
大規模なソフトウェアでは、コンパイルに時間がかかります。
そこで、Homebrewでは、多くのFormulaに対して、ビルド済みのファイルを用意しています。
利用可能なBottleがあれば、HomebrewはそのMacに対応するBottleをダウンロードし、所定の場所へ展開します。
対応するBottleがない場合は、Formulaに記載された手順に従って、ソースコードからビルドすることがあります。
依存関係も管理してくれる
ソフトウェアによっては、単体では動作せず、別のライブラリやツールを必要とします。
Homebrewでは、依存関係も確認した上で必要なパッケージがあれば一緒にインストールします。
そのため、brew installを実行したときに、指定していないパッケージまでインストールされるのはこのためです。
依存関係を確認す流には次のコマンドを使用します。
$ brew deps <パッケージ名> # 書式
$ brew deps postgresql # 例
基本のコマンド
Homebrewのバージョンを確認する
$ brew --version
パッケージを検索する
Homebrewでのパッケージ名がわからない時、複数のバージョンがあるか調べたい時、FormulaとCaskのどちらにあるか確認したい時などに使用します。
$ brew search <パッケージ名>
例:
$ brew search postgresql
✔︎ JSON API formula_tap_migrations.jws.json Downloaded 2.0KB/ 2.0KB
✔︎ JSON API cask_tap_migrations.jws.json Downloaded 2.2KB/ 2.2KB
✔︎ JSON API cask.jws.json Downloaded 18.2MB/ 18.2MB
✔︎ JSON API formula.jws.json Downloaded 33.6MB/ 33.6MB
==> Formulae
postgresql-hll postgresql@16
postgresql@12 (deprecated) postgresql@17
postgresql@13 (disabled) postgresql@18
postgresql@14 (deprecated) qt-postgresql
postgresql@15 postgrest
==> Casks
navicat-for-postgresql postgres-app
If you meant "postgresql" specifically:
postgresql breaks existing databases on upgrade without human intervention.
See a more specific version to install with:
brew formulae | grep postgresql@
パッケージの情報を確認する
バージョン、依存関係、インストール状況、注意事項などを確認できます。
$ brew info <パッケージ名>
例:
$ brew info postgresql
==> postgresql@18 ✘: stable 18.4 (bottled) [keg-only]
Object-relational database system
https://www.postgresql.org/
Aliases: postgres, postgresql
Not installed
From: https://github.com/Homebrew/homebrew-core/blob/HEAD/Formula/p/postgresql@18.rb
License: PostgreSQL
==> Dependencies
Required (7): icu4c@78 ✔, krb5 ✘, lz4 ✔, openssl@3 ↑, readline ✔, zstd ✔, gettext ✘
==> Caveats
This formula has created a default database cluster with:
initdb --locale=en_US.UTF-8 -E UTF-8 /opt/homebrew/var/postgresql@18
When uninstalling, some dead symlinks are left behind so you may want to run:
brew cleanup --prune-prefix
postgresql@18 is keg-only, which means it was not symlinked into /opt/homebrew,
because this is an alternate version of another formula.
To start postgresql@18 now and restart at login:
brew services start postgresql@18
Or, if you don't want/need a background service you can just run:
LC_ALL="en_US.UTF-8" /opt/homebrew/opt/postgresql@18/bin/postgres -D /opt/homebrew/var/postgresql@18
==> Downloading https://formulae.brew.sh/api/formula/postgresql@18.json
==> Analytics
install: 12,103 (30 days), 44,001 (90 days), 113,508 (365 days)
install-on-request: 11,736 (30 days), 42,469 (90 days), 108,489 (365 days)
build-error: 83 (30 days)
Formulaをインストールする
$ brew install <パッケージ名>
Caskをインストールする
$ brew install --cask <アプリ名>
インストール済のパッケージを確認する
$ brew list
$ brew list --formula # Formulaだけを確認する場合
$ brew list --cask # Caskだけを確認する場合
パッケージをアンインストールする
$ brew uninstall <パッケージ名> # Formulaの場合
$ brew uninstall --cask <アプリ名> # Caskの場合
不要になった依存パッケージを確認/削除する
$ brew autoremove --dry-run # 確認するだけ
$ brew autoremove # 削除する
Homebrewの状態を診断する
$ brew doctor
Homebrew本体と利用可能なパッケージの情報を最新にする
イメージとしては、Homebrewが持っている「ソフトウェア一覧表」を更新する操作。
$ brew update
更新可能パッケージを表示する
$ brew outdated
古いパッケージを新しいバージョンへ更新する
$ brew upgrade # 全てのパッケージを更新
$ brew upgrade <パッケージ名> # 特定のパッケージのみ更新
基本的ながれ:
$ brew update
$ brew outdated
$ brew upgrade
古いバージョンやキャッシュを削除
パッケージをアップグレードすると、古いバージョンやダウンロード済みのキャッシュが残ることがあります。それらを削除するには、次のコマンドを実行します。
$ brew cleanup --dry-run # 削除対象を表示
$ brew cleanup # 削除する
なお、Homebrewがアップグレード時や一定期間ごとに自動でクリーンアップするため、毎回手動で実行する必要はありません。
サービスを管理する
$ brew services list # 一覧の確認
$ brew services start <パッケージ名> # 起動する
$ brew services stop <パッケージ名> # 停止する
$ brew services restart <パッケージ名> # 再起動する
Homebrewで入れたソフトのアンインストール時の注意
brew uninstallで入れたソフトは削除できても、ソフトが作成した設定ファイルやキャッシュ、データなどは削除されないことがあります。brew uninstallで全て削除されると思ってはいけません。