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.
|
|
|
|
[Install rustup](https://www.rust-lang.org/en-US/install.html)
|
2022-02-22 21:35:48 +03:00
|
|
|
* Rust version 1.56 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,
|
2021-02-04 08:31:32 +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:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
curl https://sh.rustup.rs -sSf | sh -s
|
|
|
|
curl -LO {{ src_stable }}
|
|
|
|
tar -xzf {{ src_stable_asset }}
|
|
|
|
cd {{ src_stable_dir }}
|
2021-04-03 02:37:03 +03:00
|
|
|
./get-deps
|
2020-05-30 20:30:32 +03:00
|
|
|
cargo build --release
|
2021-03-05 08:56:49 +03:00
|
|
|
cargo run --release --bin wezterm -- start
|
2020-05-30 20:30:32 +03:00
|
|
|
```
|
|
|
|
|
|
|
|
Alternatively, use the full git repo:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
curl https://sh.rustup.rs -sSf | sh -s
|
2021-02-04 08:31:32 +03:00
|
|
|
git clone --depth=1 --branch=main --recursive https://github.com/wez/wezterm.git
|
2020-05-30 20:30:32 +03:00
|
|
|
cd wezterm
|
|
|
|
git submodule update --init --recursive
|
2021-04-03 02:37:03 +03:00
|
|
|
./get-deps
|
2020-05-30 20:30:32 +03:00
|
|
|
cargo build --release
|
2021-03-05 08:56:49 +03:00
|
|
|
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:
|
|
|
|
|
|
|
|
```bash
|
2022-09-09 18:40:05 +03:00
|
|
|
cargo build --release --no-default-features vendored-fonts
|
2021-12-24 06:30:46 +03:00
|
|
|
```
|
|
|
|
|
|
|
|
Building without X11 is not supported.
|