2020-05-30 20:30:32 +03:00
|
|
|
## 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.
|
|
|
|
|
|
|
|
* Install `rustup` to get the `rust` compiler installed on your system.
|
2024-06-09 19:50:24 +03:00
|
|
|
[Install rustup](https://www.rust-lang.org/en-US/install.html).
|
2023-07-31 06:09:15 +03:00
|
|
|
* Rust version 1.71 or later is required
|
2020-05-30 20:30:32 +03:00
|
|
|
* Build in release mode: `cargo build --release`
|
2021-03-05 08:56:49 +03:00
|
|
|
* Run it via either `cargo run --release --bin wezterm` or `target/release/wezterm`
|
2020-05-30 20:30:32 +03:00
|
|
|
|
2021-02-04 08:31:32 +03:00
|
|
|
You will need a collection of support libraries; the [`get-deps`](https://github.com/wez/wezterm/blob/main/get-deps) script will
|
2020-05-30 20:30:32 +03:00
|
|
|
attempt to install them for you. If it doesn't know about your system,
|
2024-06-09 19:50:24 +03:00
|
|
|
[please contribute instructions!](https://github.com/wez/wezterm/blob/main/CONTRIBUTING.md).
|
2020-05-30 20:30:32 +03:00
|
|
|
|
|
|
|
If you don't plan to submit a pull request to the wezterm repo, you can
|
|
|
|
download a smaller source tarball using these steps:
|
|
|
|
|
2023-03-16 05:22:51 +03:00
|
|
|
```console
|
|
|
|
$ curl https://sh.rustup.rs -sSf | sh -s
|
|
|
|
$ curl -LO {{ src_stable }}
|
|
|
|
$ tar -xzf {{ src_stable_asset }}
|
|
|
|
$ cd {{ src_stable_dir }}
|
|
|
|
$ ./get-deps
|
|
|
|
$ cargo build --release
|
|
|
|
$ cargo run --release --bin wezterm -- start
|
2020-05-30 20:30:32 +03:00
|
|
|
```
|
|
|
|
|
|
|
|
Alternatively, use the full git repo:
|
|
|
|
|
2023-03-16 05:22:51 +03:00
|
|
|
```console
|
|
|
|
$ 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
|
2020-05-30 20:30:32 +03:00
|
|
|
```
|
|
|
|
|
|
|
|
**If you get an error about zlib then you most likely didn't initialize the submodules;
|
|
|
|
take a closer look at the instructions!**
|
2021-12-24 06:30:46 +03:00
|
|
|
|
|
|
|
### 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 `build` invocation:
|
|
|
|
|
2023-03-16 05:22:51 +03:00
|
|
|
```console
|
2023-07-30 10:09:55 +03:00
|
|
|
$ cargo build --release --no-default-features --features vendored-fonts
|
2021-12-24 06:30:46 +03:00
|
|
|
```
|
|
|
|
|
|
|
|
Building without X11 is not supported.
|
2024-06-09 19:50:24 +03:00
|
|
|
|
|
|
|
### Building on Windows
|
|
|
|
|
|
|
|
When installing Rust, you must use select the MSVC version of Rust. It is the
|
|
|
|
only supported way to build wezterm.
|
|
|
|
|
|
|
|
On Windows, instead of using `get-deps`, the only other dependency that you need is
|
|
|
|
[Strawberry Perl](https://strawberryperl.com). You must ensure that you have
|
|
|
|
your `PATH` environment set up to find that particular `perl.exe` ahead of any
|
|
|
|
other perl that you may have installed on your system. This particular version
|
|
|
|
of perl is required to build openssl on Windows.
|
|
|
|
|
|
|
|
```console
|
|
|
|
$ set PATH=c:\Strawberry\perl\bin;%PATH%
|
|
|
|
```
|
|
|
|
|