wezterm/docs/install/macos.md

Installing on macOS

The CI system builds the package on macOS Big Sur and should run on systems as "old" as Mojave. It may run on earlier versions of macOS, but that has not been tested.

Starting with version 20210203-095643-70a364eb, WezTerm is a Universal binary with support for both Apple Silicon and Intel hardware.

[:simple-apple: Download for macOS :material-tray-arrow-down:]({{ macos_zip_stable }}){ .md-button } [:simple-apple: Nightly for macOS :material-tray-arrow-down:]({{ macos_zip_nightly }}){ .md-button }

1. Download Release.
2. Extract the zipfile and drag the WezTerm.app bundle to your Applications folder.
3. First time around, you may need to right click and select Open to allow launching the application that you've just downloaded from the internet.
4. Subsequently, a simple double-click will launch the UI.
5. To use wezterm binary from a terminal emulator, like wezterm ls-fonts you'll need to add the location to the wezterm binary folder that exists inside the WezTerm.app, to your environment's $PATH value. For example, to add it to your ~/.zshrc file, and assuming your WezTerm.app was installed to /Applications, add:

PATH="$PATH:/Applications/WezTerm.app/Contents/MacOS"
export PATH

5. Configuration instructions can be found here

Homebrew

WezTerm is available for brew users:

$ brew install --cask wezterm

If you'd like to use a nightly build:

$ brew tap homebrew/cask-versions
$ brew install --cask wezterm-nightly

to upgrade to a newer nightly (normal brew upgrade will not upgrade it!):

$ brew upgrade --cask wezterm-nightly --no-quarantine --greedy-latest

MacPorts

WezTerm is also available via MacPorts:

$ sudo port selfupdate
$ sudo port install wezterm