Installing on Linux using AppImage

WezTerm is available in AppImage format; a self-contained single file that doesn't require installation or any special privileges to run, and that is compatible with a wide range of Linux distributions.

Download and make the file executable and you're ready to run!

AppImage Nightly AppImage

curl -LO https://github.com/wez/wezterm/releases/download/20220624-141144-bd1b7c5d/WezTerm-20220624-141144-bd1b7c5d-Ubuntu18.04.AppImage
chmod +x WezTerm-20220624-141144-bd1b7c5d-Ubuntu18.04.AppImage

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

./WezTerm-20220624-141144-bd1b7c5d-Ubuntu18.04.AppImage

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

mkdir ~/bin
mv ./WezTerm-20220624-141144-bd1b7c5d-Ubuntu18.04.AppImage ~/bin/wezterm
~/bin/wezterm

Installing on Ubuntu and Debian-based 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.

DistroStableNightly
Ubuntu18wezterm-20220624-141144-bd1b7c5d.Ubuntu18.04.debwezterm-nightly.Ubuntu18.04.deb
Ubuntu20wezterm-20220624-141144-bd1b7c5d.Ubuntu20.04.debwezterm-nightly.Ubuntu20.04.deb
Ubuntu22wezterm-20220624-141144-bd1b7c5d.Ubuntu22.04.debwezterm-nightly.Ubuntu22.04.deb
Debian9wezterm-20220624-141144-bd1b7c5d.Debian9.12.debNo longer supported
Debian10wezterm-20220624-141144-bd1b7c5d.Debian10.debwezterm-nightly.Debian10.deb
Debian11wezterm-20220624-141144-bd1b7c5d.Debian11.debwezterm-nightly.Debian11.deb

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

curl -LO https://github.com/wez/wezterm/releases/download/20220624-141144-bd1b7c5d/wezterm-20220624-141144-bd1b7c5d.Ubuntu20.04.deb
sudo apt install -y ./wezterm-20220624-141144-bd1b7c5d.Ubuntu20.04.deb
  • The package installs /usr/bin/wezterm and /usr/share/applications/org.wezfurlong.wezterm.desktop
  • Configuration instructions can be found here

Installing on Fedora and rpm-based Systems

The CI system builds .rpm files on CentOS, Fedora and openSUSE systems. These are likely compatible with other rpm-based distributions. Alternatively, you can try the AppImage download with should work on most Linux systems.

DistroStableNightly
CentOS7wezterm-20220624_141144_bd1b7c5d-1.el7.x86_64.rpmwezterm-nightly-centos7.rpm
CentOS8wezterm-20220624_141144_bd1b7c5d-1.el8.x86_64.rpmwezterm-nightly-centos8.rpm
CentOS9wezterm-20220624_141144_bd1b7c5d-1.el9.x86_64.rpmwezterm-nightly-centos9.rpm
Fedora33wezterm-20220624_141144_bd1b7c5d-1.fc33.x86_64.rpmwezterm-nightly-fedora33.rpm
Fedora34wezterm-20220624_141144_bd1b7c5d-1.fc34.x86_64.rpmwezterm-nightly-fedora34.rpm
Fedora35wezterm-20220624_141144_bd1b7c5d-1.fc35.x86_64.rpmwezterm-nightly-fedora35.rpm
Fedora36wezterm-20220624_141144_bd1b7c5d-1.fc36.x86_64.rpmwezterm-nightly-fedora36.rpm
openSUSE LeapNighty builds onlywezterm-nightly-opensuse_leap.rpm
openSUSE TumbleweedNighty builds onlywezterm-nightly-opensuse_tumbleweed.rpm

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

sudo dnf install -y https://github.com/wez/wezterm/releases/download/20220624-141144-bd1b7c5d/wezterm-20220624_141144_bd1b7c5d-1.fc35.x86_64.rpm

WezTerm is also available in the official Factory repo in openSUSE Tumbleweed. To install from Factory instead from the rpm provided by WezTerm's Github repository, you can use Yast. If you prefer the CLI, you can install it as root user with

zypper addrepo https://download.opensuse.org/repositories/openSUSE:Factory/standard/openSUSE:Factory.repo
zypper refresh
zypper install wezterm
  • The package installs /usr/bin/wezterm and /usr/share/applications/org.wezfurlong.wezterm.desktop
  • Configuration instructions can be found here

Arch Linux

WezTerm is available in the Community repository.

The version available in the community repository may lag behind the latest wezterm release, so you may wish to use one of these AUR options:

WhatWhere
Nightly Binarieshttps://aur.archlinux.org/packages/wezterm-nightly-bin/
Build from sourcehttps://aur.archlinux.org/packages/wezterm-git/

Alpine Linux

APKs are built out from the main branch.

VersionStableNightly
3.12wezterm-nightly-alpine3.12.apk
3.13wezterm-nightly-alpine3.13.apk
3.14wezterm-nightly-alpine3.14.apk
3.15wezterm-nightly-alpine3.15.apk

Linuxbrew Tap

If you are a Linuxbrew user, you can install wezterm from our tap:

$ brew tap wez/wezterm-linuxbrew
$ brew install wezterm

If you'd like to use a nightly build you can perform a head install:

$ brew install --HEAD wezterm

to upgrade to a newer nightly, it is simplest to remove then install:

$ brew rm wezterm
$ brew install --HEAD wezterm

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