Build from source
Installing from source¶
If your system isn't covered by the pre-built packages then you can build it for yourself. WezTerm should run on any modern unix as well as Windows 10 and macOS.
rustupto get the
rustcompiler installed on your system. Install rustup
- Rust version 1.56 or later is required
- Build in release mode:
cargo build --release
- Run it via either
cargo run --release --bin weztermor
You will need a collection of support libraries; the
get-deps script will
attempt to install them for you. If it doesn't know about your system,
please contribute instructions!
If you don't plan to submit a pull request to the wezterm repo, you can download a smaller source tarball using these steps:
$ curl https://sh.rustup.rs -sSf | sh -s $ curl -LO https://github.com/wez/wezterm/releases/download/20230326-111934-3666303c/wezterm-20230326-111934-3666303c-src.tar.gz $ tar -xzf wezterm-20230326-111934-3666303c-src.tar.gz $ cd wezterm-20230326-111934-3666303c $ ./get-deps $ cargo build --release $ cargo run --release --bin wezterm -- start
Alternatively, use the full git repo:
$ curl https://sh.rustup.rs -sSf | sh -s $ git clone --depth=1 --branch=main --recursive https://github.com/wez/wezterm.git $ cd wezterm $ git submodule update --init --recursive $ ./get-deps $ cargo build --release $ cargo run --release --bin wezterm -- start
If you get an error about zlib then you most likely didn't initialize the submodules; take a closer look at the instructions!
Building without Wayland support on Unix systems¶
By default, support for both X11 and Wayland is included on Unix systems.
If your distribution has X11 but not Wayland, then you can build WezTerm without
Wayland support by changing the
Building without X11 is not supported.