mirror of
https://github.com/wez/wezterm.git
synced 2024-12-26 23:04:49 +03:00
196 lines
8.1 KiB
Markdown
196 lines
8.1 KiB
Markdown
## Installing on Linux via Flathub
|
|
|
|
WezTerm is available in flatpak format and published on
|
|
[Flathub](https://flathub.org/apps/details/org.wezfurlong.wezterm), which is
|
|
aggregated into the GNOME Software application and other similar
|
|
storefront/software catalog applications.
|
|
|
|
<a href='https://flathub.org/apps/details/org.wezfurlong.wezterm'><img width='240' alt='Download on Flathub' src='https://flathub.org/assets/badges/flathub-badge-en.png'/></a>
|
|
|
|
To install using the command line:
|
|
|
|
First, [setup flatpak on your system](https://flatpak.org/setup/), then:
|
|
|
|
```bash
|
|
flatpak install flathub org.wezfurlong.wezterm
|
|
```
|
|
|
|
and then run:
|
|
|
|
```bash
|
|
flatpak run org.wezfurlong.wezterm
|
|
```
|
|
|
|
You may wish to define an alias for convenience:
|
|
|
|
```bash
|
|
alias wezterm='flatpak run org.wezfurlong.wezterm'
|
|
```
|
|
|
|
Note: flatpaks run in a sandbox so some functionality may behave a little
|
|
differently when compared to installing the native package format for your
|
|
system. In particular, starting wezterm using `wezterm cli` subcommands will
|
|
block on the first run since you logged in if you haven't already launched the
|
|
gui.
|
|
|
|
Only stable releases are allowed to be published to Flathub, so if
|
|
you want/need to try a nightly download you will need to use one of
|
|
the other options below.
|
|
|
|
## 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 }}) |No longer supported|
|
|
|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 }})|
|
|
|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 }}) |No longer provided|
|
|
|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 }})|
|
|
|Fedora37 |Nightly builds only |[{{ fedora37_rpm_nightly_asset }}]({{ fedora37_rpm_nightly }})|
|
|
|openSUSE Leap |[{{ opensuse_leap_rpm_stable_asset }}]({{ opensuse_leap_rpm_stable }})|[{{ opensuse_leap_rpm_nightly_asset }}]({{ opensuse_leap_rpm_nightly }})|
|
|
|openSUSE Tumbleweed |[{{ opensuse_tumbleweed_rpm_stable_asset }}]({{ opensuse_tumbleweed_rpm_stable }})|[{{ 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|
|
|
|---------------------|-|
|
|
|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_stable_asset }}]({{ alpine3_12_apk_stable }})|[{{ alpine3_12_apk_nightly_asset }}]({{ alpine3_12_apk_nightly }})|
|
|
| 3.13 |[{{ alpine3_13_apk_stable_asset }}]({{ alpine3_13_apk_stable }})|[{{ alpine3_13_apk_nightly_asset }}]({{ alpine3_13_apk_nightly }})|
|
|
| 3.14 |[{{ alpine3_14_apk_stable_asset }}]({{ alpine3_14_apk_stable }})|[{{ alpine3_14_apk_nightly_asset }}]({{ alpine3_14_apk_nightly }})|
|
|
| 3.15 |[{{ alpine3_15_apk_stable_asset }}]({{ alpine3_15_apk_stable }})|[{{ 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>
|
|
|
|
|