mirror of
https://github.com/wez/wezterm.git
synced 2024-12-27 23:46:31 +03:00
c667224674
The toolchain has problems compiling harfbuzz 4.4.1 and I don't feel like troubleshooting it.
158 lines
6.7 KiB
Markdown
158 lines
6.7 KiB
Markdown
## Installing on Linux using AppImage
|
|
|
|
WezTerm is available in [AppImage](https://appimage.org/) 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!
|
|
|
|
<a href="{{ ubuntu18_AppImage_stable }}" class="btn">AppImage</a>
|
|
<a href="{{ ubuntu18_AppImage_nightly }}" class="btn">Nightly AppImage</a>
|
|
|
|
```bash
|
|
curl -LO {{ ubuntu18_AppImage_stable }}
|
|
chmod +x {{ ubuntu18_AppImage_stable_asset }}
|
|
```
|
|
|
|
You may then execute the appimage directly to launch wezterm, with no
|
|
specific installation steps required:
|
|
|
|
```bash
|
|
./{{ ubuntu18_AppImage_stable_asset }}
|
|
```
|
|
|
|
That said, you may wish to make it a bit more convenient:
|
|
|
|
```bash
|
|
mkdir ~/bin
|
|
mv ./{{ ubuntu18_AppImage_stable_asset }} ~/bin/wezterm
|
|
~/bin/wezterm
|
|
```
|
|
|
|
* Configuration instructions can be [found here](../config/files.html)
|
|
|
|
## 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.
|
|
|
|
|Distro | Stable | Nightly |
|
|
|------------|------------------|---------------------|
|
|
|Ubuntu18 |[{{ ubuntu18_deb_stable_asset }}]({{ ubuntu18_deb_stable }}) |[{{ ubuntu18_deb_nightly_asset }}]({{ ubuntu18_deb_nightly }})|
|
|
|Ubuntu20 |[{{ ubuntu20_deb_stable_asset }}]({{ ubuntu20_deb_stable }}) |[{{ ubuntu20_deb_nightly_asset }}]({{ ubuntu20_deb_nightly }})|
|
|
|Ubuntu22 |[{{ ubuntu22_deb_stable_asset }}]({{ ubuntu22_deb_stable }}) |[{{ ubuntu22_deb_nightly_asset }}]({{ ubuntu22_deb_nightly }})|
|
|
|Debian9 |[{{ debian9_deb_stable_asset }}]({{ debian9_deb_stable }}) |*No longer supported*|
|
|
|Debian10 |[{{ debian10_deb_stable_asset }}]({{ debian10_deb_stable }}) |[{{ debian10_deb_nightly_asset }}]({{ debian10_deb_nightly }})|
|
|
|Debian11 |[{{ debian11_deb_stable_asset }}]({{ debian11_deb_stable }}) |[{{ debian11_deb_nightly_asset }}]({{ debian11_deb_nightly }})|
|
|
|
|
To download and install from the CLI, you can use something like this, which
|
|
shows how to install the Ubuntu 20 package:
|
|
|
|
```bash
|
|
curl -LO {{ ubuntu20_deb_stable }}
|
|
sudo apt install -y ./{{ ubuntu20_deb_stable_asset }}
|
|
```
|
|
|
|
* The package installs `/usr/bin/wezterm` and `/usr/share/applications/org.wezfurlong.wezterm.desktop`
|
|
* Configuration instructions can be [found here](../config/files.html)
|
|
|
|
## 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.
|
|
|
|
|Distro | Stable | Nightly |
|
|
|------------|------------------|---------------------|
|
|
|CentOS7 |[{{ centos7_rpm_stable_asset }}]({{ centos7_rpm_stable }}) |[{{ centos7_rpm_nightly_asset }}]({{ centos7_rpm_nightly }})|
|
|
|CentOS8 |[{{ centos8_rpm_stable_asset }}]({{ centos8_rpm_stable }}) |[{{ centos8_rpm_nightly_asset }}]({{ centos8_rpm_nightly }})|
|
|
|CentOS9 |[{{ centos9_rpm_stable_asset }}]({{ centos9_rpm_stable }})|[{{ centos9_rpm_nightly_asset }}]({{ centos9_rpm_nightly }})|
|
|
|Fedora33 |[{{ fedora33_rpm_stable_asset }}]({{ fedora33_rpm_stable }}) |[{{ fedora33_rpm_nightly_asset }}]({{ fedora33_rpm_nightly }})|
|
|
|Fedora34 |[{{ fedora34_rpm_stable_asset }}]({{ fedora34_rpm_stable }}) |[{{ fedora34_rpm_nightly_asset }}]({{ fedora34_rpm_nightly }})|
|
|
|Fedora35 |[{{ fedora35_rpm_stable_asset }}]({{ fedora35_rpm_stable }}) |[{{ fedora35_rpm_nightly_asset }}]({{ fedora35_rpm_nightly }})|
|
|
|Fedora36 |[{{ fedora36_rpm_stable_asset }}]({{ fedora36_rpm_stable }})|[{{ fedora36_rpm_nightly_asset }}]({{ fedora36_rpm_nightly }})|
|
|
|openSUSE Leap |Nighty builds only|[{{ opensuse_leap_rpm_nightly_asset }}]({{ opensuse_leap_rpm_nightly }})|
|
|
|openSUSE Tumbleweed |Nighty builds only|[{{ opensuse_tumbleweed_rpm_nightly_asset }}]({{ opensuse_tumbleweed_rpm_nightly }})|
|
|
|
|
To download and install from the CLI you can use something like this, which
|
|
shows how to install the Fedora 35 package:
|
|
|
|
```bash
|
|
sudo dnf install -y {{ fedora35_rpm_stable }}
|
|
```
|
|
|
|
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
|
|
|
|
```bash
|
|
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](../config/files.html)
|
|
|
|
## Arch Linux
|
|
|
|
WezTerm is available in the [Community repository](https://archlinux.org/packages/community/x86_64/wezterm/).
|
|
|
|
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:
|
|
|
|
|What |Where|
|
|
|---------------------|-|
|
|
|Nightly Binaries |<https://aur.archlinux.org/packages/wezterm-nightly-bin/>|
|
|
|Build from source |<https://aur.archlinux.org/packages/wezterm-git/>|
|
|
|
|
## Alpine Linux
|
|
|
|
APKs are built out from the `main` branch.
|
|
|
|
|Version | Stable | Nightly |
|
|
|--------|---------------|---------|
|
|
| 3.12 | |[{{ alpine3_12_apk_nightly_asset }}]({{ alpine3_12_apk_nightly }})|
|
|
| 3.13 | |[{{ alpine3_13_apk_nightly_asset }}]({{ alpine3_13_apk_nightly }})|
|
|
| 3.14 | |[{{ alpine3_14_apk_nightly_asset }}]({{ alpine3_14_apk_nightly }})|
|
|
| 3.15 | |[{{ alpine3_15_apk_nightly_asset }}]({{ alpine3_15_apk_nightly }})|
|
|
|
|
## Linuxbrew Tap
|
|
|
|
If you are a [Linuxbrew](https://docs.brew.sh/Homebrew-on-Linux) user, you can install
|
|
wezterm from our tap:
|
|
|
|
```bash
|
|
$ brew tap wez/wezterm-linuxbrew
|
|
$ brew install wezterm
|
|
```
|
|
|
|
If you'd like to use a nightly build you can perform a head install:
|
|
|
|
```bash
|
|
$ brew install --HEAD wezterm
|
|
```
|
|
|
|
to upgrade to a newer nightly, it is simplest to remove then
|
|
install:
|
|
|
|
```bash
|
|
$ 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.
|
|
|
|
<a href="{{ linux_raw_bin_stable }}" class="btn">Download raw Linux binaries</a>
|
|
<a href="{{ linux_raw_bin_nightly }}" class="btn">Nightly raw Linux binaries</a>
|
|
|
|
|