wezterm/docs/installation.markdown

Installing on Windows

Windows 10 or later is required to run WezTerm.

Download for Windows Nightly for Windows

1. Download Release
2. Extract the zipfile and double-click wezterm.exe to run the UI
3. Configuration instructions can be found here

Installing 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.

Download for macOS Nightly for macOS

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 your just downloaded from the internet.
4. Subsequently, a simple double-click will launch the UI
5. Configuration instructions can be found here

Installing on Ubuntu and Debian Systems

The CI system builds .deb files for a variety of Ubuntu and Debian distributions. These are often compatible with other Debian style systems; if you don't find one that exactly matches your system you can try installing one from an older version of your distribution, or use one of the Debian packages linked below. Failing that, you can try the AppImage download which should work on most Linux systems.

Distro	Stable	Nightly
Ubuntu16	[{{ ubuntu16_deb_stable_asset }}]({{ ubuntu16_deb_stable }})	[{{ ubuntu16_deb_nightly_asset }}]({{ ubuntu16_deb_nightly }})
Ubuntu18	[{{ ubuntu18_deb_stable_asset }}]({{ ubuntu18_deb_stable }})	[{{ ubuntu18_deb_nightly_asset }}]({{ ubuntu18_deb_nightly }})
Ubuntu19	[{{ ubuntu19_deb_stable_asset }}]({{ ubuntu19_deb_stable }})	[{{ ubuntu19_deb_nightly_asset }}]({{ ubuntu19_deb_nightly }})
Debian9	[{{ debian9_deb_stable_asset }}]({{ debian9_deb_stable }})	[{{ debian9_deb_nightly_asset }}]({{ debian9_deb_nightly }})
Debian10	[{{ debian10_deb_stable_asset }}]({{ debian10_deb_stable }})	[{{ debian10_deb_nightly_asset }}]({{ debian10_deb_nightly }})

To download and install from the CLI, you can use something like this, which shows how to install the Ubuntu 16 package:

curl -LO {{ ubuntu16_deb_stable }}
sudo apt install -y ./{{ ubuntu16_deb_stable_asset }}

• The package installs /usr/bin/wezterm and /usr/share/applications/org.wezfurlong.wezterm.desktop
• Configuration instructions can be found here

Installing on Fedora

The CI system builds an .rpm file on Fedora 31.

Download for Fedora Nightly for Fedora

sudo dnf install -y {{ fedora31_rpm_stable }}

• The package installs /usr/bin/wezterm and /usr/share/applications/org.wezfurlong.wezterm.desktop
• Configuration instructions can be found here

Installing on CentOS

The CI system builds an .rpm file on CentOS 7.

Download for CentOS Nightly for CentOS

sudo dnf install -y {{ centos7_rpm_stable }}

• The package installs /usr/bin/wezterm and /usr/share/applications/org.wezfurlong.wezterm.desktop
• Configuration instructions can be found here

Installing on Linux via AppImage

If you have some other Linux system, or otherwise prefer AppImage over your system package format, you can download a build by following these steps.

AppImage Nightly AppImage

curl -LO {{ ubuntu16_AppImage_stable }}
chmod +x {{ ubuntu16_AppImage_stable_asset }}

You may then execute the appimage directly to launch wezterm, with no specific installation steps required:

./{{ ubuntu16_AppImage_stable_asset }}

That said, you may wish to make it a bit more convenient:

mkdir ~/bin
mv ./{{ ubuntu16_AppImage_stable_asset }} ~/bin/wezterm
~/bin/wezterm

• Configuration instructions can be found here

Raw Linux Binary

Another option for linux is a raw binary archive. These are the same binaries that are built for Ubuntu but provided in a tarball.

Download raw Linux binaries Nightly raw Linux binaries

Installing from source

If your system isn't covered by the list above, 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
• Rust version 1.41 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 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 {{ src_stable }}
tar -xzf {{ src_stable_asset }}
cd {{ src_stable_dir }}
sudo ./get-deps
cargo build --release
cargo run --release -- start

Alternatively, use the full git repo:

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