Linux

Flatpak#

Installing on Linux via Flathub#

wakterm is available in flatpak format and published on Flathub, which is aggregated into the GNOME Software application and other similar storefront/software catalog applications.

flatpaks run in an isolated sandbox which can cause some issues especially for power users. It is recommended that you graduate to a native package if/when you decide to fully embrace wakterm.

To install using the command line:

First, setup flatpak on your system, then:

$ flatpak install flathub org.wezfurlong.wakterm

and then run:

$ flatpak run org.wezfurlong.wakterm

You may wish to define an alias for convenience:

$ alias wakterm='flatpak run org.wezfurlong.wakterm'

flatpaks run in an isolated sandbox so some functionality may behave a little differently when compared to installing the native package format for your system.

starting wakterm using wakterm cli subcommands will block on the first run since you logged in if you haven't already launched the gui.

Process inspection functions such as determining the current directory for a pane will not work

The flatpak is provided primarily for ease of trying out wakterm with low commitment, and you are encouraged to use native packages for your system once you're ready to get the most out of wakterm.

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 installation options.

AppImage#

Installing on Linux using AppImage#

wakterm 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 download Nightly AppImage download

$ curl -LO https://github.com/wakamex/wakterm/releases
$ chmod +x See releases page

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

$ ./See releases page

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

$ mkdir ~/bin
$ mv ./See releases page ~/bin/wakterm
$ ~/bin/wakterm

Configuration instructions can be found here

Ubuntu/Debian#

Using the APT repo#

You can configure your system to use that APT repo by following these steps:

$ curl -fsSL https://apt.fury.io/wez/gpg.key | sudo gpg --yes --dearmor -o /usr/share/keyrings/wakterm-fury.gpg
$ echo 'deb [signed-by=/usr/share/keyrings/wakterm-fury.gpg] https://apt.fury.io/wez/ * *' | sudo tee /etc/apt/sources.list.d/wakterm.list
$ sudo chmod 644 /usr/share/keyrings/wakterm-fury.gpg

Update your dependencies:

$ sudo apt update

Now you can install wakterm:

$ sudo apt install wakterm

or to install a nightly build:

$ sudo apt install wakterm-nightly

The nightly build conflicts with the regular build, so you may install one or the other, but not both at the same time.

Pre-built `.deb` packages#

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
Ubuntu20	amd64		amd64
Ubuntu22	amd64	arm64	amd64	arm64
Ubuntu24	Nightly Only	Nightly Only	amd64	arm64
Debian11	amd64		amd64
Debian12	amd64	arm64	amd64	arm64

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

$ curl -LO https://github.com/wakamex/wakterm/releases
$ sudo apt install -y ./See releases page

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

Copr#

Installing on Fedora and rpm-based Systems via Copr#

Nightly builds of wakterm are now available via the Copr build service.

You can see the current list of available distributions and architectures on the wakterm-nightly project page. At the time that this page was written, the following distributions are available in Copr for x86_64 and aarch64:

Centos Stream 8 and 9
Fedora 38, 39, 40, rawhide
openSUSE Leap 15.5
openSUSE Tumbleweed
RHEL 8, 9

To perform initial installation:

$ sudo dnf copr enable wezfurlong/wakterm-nightly
$ sudo dnf install wakterm

Fedora Atomic Desktops (Silverblue, Kinoite) specific#

To perform initial installation:

$ sudo wget https://copr.fedorainfracloud.org/coprs/wezfurlong/wakterm-nightly/repo/fedora-$(rpm -E %fedora)/wezfurlong-wakterm-nightly-fedora-$(rpm -E %fedora).repo -O /etc/yum.repos.d/_copr:copr.fedorainfracloud.org:wezfurlong:wakterm-nightly.repo
$ sudo rpm-ostree install wakterm

openSUSE specific#

To perform initial installation:

$ sudo zypper in dnf
$ sudo dnf copr enable wezfurlong/wakterm-nightly <repository>

where <repository> is one of the following, depending on the flavor and architecture: opensuse-tumbleweed-x86_64, opensuse-tumbleweed-aarch64, opensuse-leap-15.5-x86_64, opensuse-leap-15.5-aarch64.

$ sudo dnf install wakterm

Update#

$ sudo dnf update wakterm

Fedora/RPM#

Installing on Fedora and rpm-based Systems#

It is recommended that you install via Copr so that it is easiest to stay up to date as future versions of wakterm are released.

The CI system builds .rpm files on CentOS and Fedora 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
CentOS8	See releases page	No longer supported
CentOS9	See releases page	See releases page
Fedora37	See releases page	No longer supported
Fedora38	See releases page	No longer supported
Fedora39	See releases page	See releases page
Fedora40	Nightly only	See releases page

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

$ sudo dnf install -y https://github.com/wakamex/wakterm/releases

openSUSE#

It is recommended that you install via Copr so that it is easiest to stay up to date as future versions of wakterm are released.

openSUSE Tumbleweed/Slowroll#

The stable version of wakterm is available in the official repositories.

$ zypper install wakterm

openSUSE Leap#

Use Copr or build if from source.

Arch#

Arch Linux#

wakterm is available in the Extra repository.

Be sure to also install the ttf-nerd-fonts-symbols-mono package!

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

What	Where
Build from source	https://aur.archlinux.org/packages/wakterm-git/

Linuxbrew#

Linuxbrew Tap#

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

$ brew tap wakterm/wakterm-linuxbrew
$ brew install wakterm

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

$ brew install --HEAD wakterm

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

$ brew rm wakterm
$ brew install --HEAD wakterm

Nix/NixOS#

Nix#

wakterm is available in nixpkgs as wakterm.

{
    # configuration.nix

    environment.systemPackages = [
        pkgs.wakterm
    ]
}

Git must be available in $PATH before attempting install

The Wezterm package uses Nix's builtins.fetchGit which depends on the git binary being available in $PATH during the evaluation phase (before building packages).

Git must be installed before attempting to install wakterm.

Note: builtins.fetchGit is used because of cargoLock.allowBuiltinFetchGit in buildRustPackage call.

(This is a known Nix issue, tracked in nix#3533 & nix#9807)

Flake#

If you need a newer version use the flake. Use the cachix if you want to avoid building wakterm from source.

The flake is in the nix directory, so the url will be something like github:wakterm/wakterm?dir=nix

Here's an example for NixOS configurations:

{
    inputs.wakterm.url = "github:wakterm/wakterm?dir=nix";
    # ...

    outputs = inputs @ {nixpkgs, ...}:{
        nixosConfigurations.HOSTNAME = nixpkgs.lib.nixosSystem {
            specialArgs = { inherit inputs; }; # Make sure you pass inputs through to your nixosConfiguration like this
            modules = [
                # ...
            ];
        };
    };
}

And for home-manager you can do the following:

# flake.nix

{
    inputs.wakterm.url = "github:wakterm/wakterm?dir=nix";
    # ...

    outputs = inputs @ {nixpkgs, home-manager, ...}:{
        homeConfigurations."user@HOSTNAME" = home-manager.lib.homeManagerConfiguration {
            pkgs = nixpkgs.legacyPackages.x86_64-linux;
            extraSpecialArgs = { inherit inputs; }; # Pass inputs to homeManagerConfiguration
            modules = [
                ./home.nix
            ];
        };        
    };
}

# home.nix

{inputs, pkgs, ...}:{
    programs.wakterm = {
        enable = true;
        package = inputs.wakterm.packages.${pkgs.system}.default;
    };
}

Cachix#

Successful builds of the nightly nix action are pushed to this binary cache.

# nixosConfiguration module
{
    nix.settings = {
        substituters = ["https://wakterm.cachix.org"];
        trusted-public-keys = ["wakterm.cachix.org-1:kAbhjYUC9qvblTE+s7S+kl5XM1zVa4skO+E/1IDWdH0="];
    };
}

Raw#

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.

Raw Linux Binary download Nightly Raw Linux Binary download

Linux

Flatpak#

Installing on Linux via Flathub#

AppImage#

Installing on Linux using AppImage#

Ubuntu/Debian#

Using the APT repo#

Pre-built .deb packages#

Copr#

Installing on Fedora and rpm-based Systems via Copr#

Fedora Atomic Desktops (Silverblue, Kinoite) specific#

openSUSE specific#

Update#

Fedora/RPM#

Installing on Fedora and rpm-based Systems#

openSUSE#

openSUSE#

openSUSE Tumbleweed/Slowroll#

openSUSE Leap#

Arch#

Arch Linux#

Linuxbrew#

Linuxbrew Tap#

Nix/NixOS#

Nix#

Flake#

Cachix#

Raw#

Raw Linux Binary#

Pre-built `.deb` packages#