mirror of
https://github.com/wez/wezterm.git
synced 2024-11-10 15:04:32 +03:00
a11f036d87
Build the docs by installing mdbook and then running: `mdbook build docs` or run them live with `mdbook serve docs`
112 lines
4.5 KiB
Markdown
112 lines
4.5 KiB
Markdown
---
|
|
title: Installation
|
|
---
|
|
|
|
{% assign releases = site.github.releases | sort:"created_at" | reverse %}
|
|
{% for r in releases %}
|
|
{% if r.prerelease %}
|
|
{% for asset in r.assets %}
|
|
{% if asset.name contains 'windows' and windows_pre == nil %}
|
|
{% assign windows_pre = asset.browser_download_url %}
|
|
{% endif %}
|
|
{% if asset.name contains 'macos' and macos_pre == nil %}
|
|
{% assign macos_pre = asset.browser_download_url %}
|
|
{% endif %}
|
|
{% if asset.name contains '.deb' and deb_pre == nil %}
|
|
{% assign deb_pre = asset.browser_download_url %}
|
|
{% endif %}
|
|
{% if asset.name contains '.rpm' and fedora_pre == nil %}
|
|
{% assign fedora_pre = asset.browser_download_url %}
|
|
{% endif %}
|
|
{% endfor %}
|
|
{% else %}
|
|
{% for asset in r.assets %}
|
|
{% if asset.name contains 'windows' and windows_stable == nil %}
|
|
{% assign windows_stable = asset.browser_download_url %}
|
|
{% endif %}
|
|
{% if asset.name contains 'macos' and macos_stable == nil %}
|
|
{% assign macos_stable = asset.browser_download_url %}
|
|
{% endif %}
|
|
{% if asset.name contains '.deb' and deb_stable == nil %}
|
|
{% assign deb_stable = asset.browser_download_url %}
|
|
{% assign deb_stable_asset = asset.name %}
|
|
{% endif %}
|
|
{% if asset.name contains '.rpm' and fedora_stable == nil %}
|
|
{% assign fedora_stable = asset.browser_download_url %}
|
|
{% assign fedora_stable_asset = asset.name %}
|
|
{% endif %}
|
|
{% endfor %}
|
|
{% endif %}
|
|
{% endfor %}
|
|
|
|
|
|
## Installing a pre-built package on Windows
|
|
|
|
Windows 10 or later is required to run WezTerm.
|
|
|
|
<a href="{{ windows_stable }}" class="btn">Download for Windows</a>
|
|
<a href="{{ windows_pre }}" class="btn">Nightly for Windows</a>
|
|
1. Download <a href="{{ windows_stable }}">Release</a>
|
|
2. Extract the zipfile and double-click `wezterm.exe` to run the UI
|
|
3. Configuration instructions can be [found here](configuration.html)
|
|
|
|
## Installing a pre-built package on macOS
|
|
|
|
The CI system builds the package on macOS Mojave (10.14). It may run on earlier
|
|
versions of macOS, but that has not been tested.
|
|
|
|
<a href="{{ macos_stable }}" class="btn">Download for macOS</a>
|
|
<a href="{{ macos_pre }}" class="btn">Nightly for macOS</a>
|
|
1. Download <a href="{{ macos_stable }}">Release</a>
|
|
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 your just downloaded from the internet.
|
|
3. Subsequently, a simple double-click will launch the UI
|
|
4. Configuration instructions can be [found here](configuration.html)
|
|
|
|
## Installing a pre-built package on Ubuntu
|
|
|
|
The CI system builds a `.deb` file on Ubuntu 16.04. It is compatible with other
|
|
debian style systems, including Debian 9 (Stretch) and later versions.
|
|
|
|
<a href="{{ deb_stable }}" class="btn">Download for Ubuntu</a>
|
|
<a href="{{ deb_pre }}" class="btn">Nightly for Ubuntu</a>
|
|
* <tt>curl -LO <a href="{{ deb_stable }}">{{ deb_stable }}</a></tt>
|
|
* `sudo apt install -y ./{{ deb_stable_asset }}`
|
|
* The package installs `/usr/bin/wezterm` and `/usr/share/applications/wezterm.desktop`
|
|
* Configuration instructions can be [found here](configuration.html)
|
|
|
|
## Installing a pre-built package on Fedora
|
|
|
|
The CI system builds an `.rpm` file on Fedora 31.
|
|
|
|
<a href="{{ fedora_stable }}" class="btn">Download for Fedora</a>
|
|
<a href="{{ fedora_pre }}" class="btn">{Nightly for Fedora</a>
|
|
* <tt>curl -LO <a href="{{ fedora_stable }}">{{ fedora_stable }}</a></tt>
|
|
* `sudo dnf install -y ./{{ fedora_stable_asset }}`
|
|
* The package installs `/usr/bin/wezterm` and `/usr/share/applications/wezterm.desktop`
|
|
* Configuration instructions can be [found here](configuration.html)
|
|
|
|
## Installing from source
|
|
|
|
* Install `rustup` to get the `rust` compiler installed on your system.
|
|
[Install rustup](https://www.rust-lang.org/en-US/install.html)
|
|
* Rust version 1.39 or later is required
|
|
* Build in release mode: `cargo build --release`
|
|
* Run it via either `cargo run --release` or `target/release/wezterm`
|
|
|
|
You will need a collection of support libraries; the [`get-deps`](https://github.com/wez/wezterm/blob/master/get-deps) script will
|
|
attempt to install them for you. If it doesn't know about your system,
|
|
[please contribute instructions!](https://github.com/wez/wezterm/blob/master/CONTRIBUTING.md)
|
|
|
|
```
|
|
$ curl https://sh.rustup.rs -sSf | sh -s
|
|
$ git clone --depth=1 --branch=master --recursive https://github.com/wez/wezterm.git
|
|
$ cd wezterm
|
|
$ git submodule update --init --recursive
|
|
$ sudo ./get-deps
|
|
$ cargo build --release
|
|
$ cargo run --release -- start
|
|
```
|
|
|