How to Use Alacritty: The Minimal GPU Terminal (TOML Config, Vi Mode, and the tmux Pairing)

CodexFuse Team · 2026-11-04T11:18:03.406Z · 10 min read min read

How to use Alacritty, the minimal GPU terminal: install it, write one TOML config, master vi mode, and pair it with tmux — a tested walkthrough with config tables and verified 0.17.0 facts.

How to Use Alacritty: The Minimal GPU Terminal (TOML Config, Vi Mode, and the tmux Pairing)

Learning how to use Alacritty is mostly an exercise in subtraction: this is a fast, cross-platform, OpenGL terminal emulator written in Rust that ships with no tabs, no split panes, and no settings dialog — just one TOML file and a window that stays out of your way. If that philosophy sounds familiar, its closest modern cousin is covered in our Ghostty guide; this page is the Alacritty lane — the deliberately minimal one.

This guide walks through the full workflow: installing Alacritty on macOS, Linux, and Windows, finding and writing your first alacritty.toml, the keyboard shortcuts worth learning first, vi mode for mouse-free scrollback, the tmux pairing that replaces tabs, the $TERM question, and theming. Every version claim is verified against the 0.17.0 release (6 April 2026) and the current official man pages, as of 2026-11-04.

What Is Alacritty, and What Does It Refuse to Be?

Alacritty is a free and open-source, GPU-accelerated terminal emulator focused on performance and simplicity, written in Rust and using OpenGL — that is Wikipedia's summary, and the official man page tagline reads "Alacritty — A fast, cross-platform, OpenGL terminal emulator." It runs on macOS, Linux, BSD, and Windows, and the current stable release is 0.17.0, released 6 April 2026 (reported by Linuxiac on 7 April 2026 and confirmed in the official CHANGELOG on the GitHub releases page; there is no stable 0.18.0).

The refusal is the product. Wikipedia, citing Alacritty's own docs, notes that "Alacritty explicitly does not support tabs or splits because similar functionality can be achieved with a terminal multiplexer or window manager." The man page states the design rule behind it: "By integrating with other applications, rather than reimplementing their functionality, it manages to provide a flexible set of features with high performance." A bundl.run comparison from October 2026 puts it plainly: the "stay out of the way" approach is a feature, not a bug.

How Do You Install Alacritty on macOS, Linux, and Windows?

Installation is one command on every major OS — Alacritty ships through the normal package managers, with no installer wizard and no account. Run the one for your system, then verify with alacritty --version.

1. macOS — brew install --cask alacritty (the primary route, confirmed current as of October 2026 by bundl.run; alacritty.dev also offers a .dmg).
2. Ubuntu / Debian — sudo apt install alacritty. As of October 2026, Ubuntu 26.04 ships 0.16.1 and Ubuntu 24.04 ships 0.13.2; for 0.17.0 use the Snapcrafters snap, sudo snap install --classic alacritty (tested October 2026 by computingforgeeks, which notes the old aslatter PPA is stale and not recommended).
3. Arch Linux — sudo pacman -S alacritty.
4. Fedora — sudo dnf install alacritty (Fedora 43's official repo ships 0.15.1); for newer builds, the COPR sudo dnf copr enable pschyska/alacritty route (idroot.us).
5. Windows — scoop install alacritty (extras bucket) or choco install alacritty, per the official README; the GitHub releases page also offers an official .msi.

If your terminal exists mainly to reach servers, this workflow pairs naturally with our VPS hosting guide — Alacritty is the local end, the VPS is the remote one.

Where Does the Alacritty Config File Live?

Alacritty never creates a config file for you — it searches a fixed lookup order and uses the first one it finds, so on most Linux desktops you simply create ~/.config/alacritty/alacritty.toml. The format has been TOML since 0.13.0 (January 2024); if you are migrating from an old alacritty.yml, run alacritty migrate, the documented subcommand that converts it.

The exact lookup order from the current official man page is:

On Windows the config is looked for in one place: %APPDATA%\alacritty\alacritty.toml.

How Do You Write Your First alacritty.toml?

One small TOML file configures everything — window, font, colors, keybindings — and edits apply live, because live_config_reload defaults to true in the [general] table (verified in the current alacritty(5) man page). Only settings tagged "changes require restart" need a relaunch.

The starter below is deliberately small; it parsed cleanly with Python's TOML parser when this article was written, and every key comes from the current official config reference:

[general]
live_config_reload = true

[window]
padding = { x = 8, y = 8 }
opacity = 0.95

[font]
size = 13.0

[colors.primary]
background = "#0d1117"
foreground = "#e6edf3"

A few notes on what those do: padding adds blank space around the window in pixels, opacity is background transparency from 0.0 to 1.0 (default 1.0), font.size is in points (default 11.25), and [colors.primary] sets the base foreground/background in #RRGGBB. The window title defaults to "Alacritty" if you ever want to change it.

What Are the First Alacritty Keyboard Shortcuts to Learn?

The essentials are all Ctrl+Shift combos: copy is Ctrl+Shift+C, paste is Ctrl+Shift+V, and font size is Ctrl+= / Ctrl+- / Ctrl+0. One honest caveat before the table: there is no default new-window binding on Linux or Windows (it exists only on macOS as Cmd+N) — the portable route is the alacritty msg create-window command.

All of the above come from the official default-bindings man page, alacritty-bindings(5), as of 0.17.0.

How Does Vi Mode Work in Alacritty?

Press Ctrl+Shift+Space and your scrollback becomes a Vim buffer: navigate with h, j, k, and l, press v to start a selection and y to copy it, / to search forward (? for backward), and Enter to open the URL under the cursor. Press I or Ctrl+C to leave.

The official docs describe it as a full vi-style mode over history: selection modes available with the mouse are all reachable from vi mode, including semantic (Alt+v), line (Shift+v), and block (Ctrl+v) selection. Inside vi mode, Ctrl+F / Ctrl+B do inline search forward and backward, and N / Shift+N jump to the next and previous search match. The 0.16.x releases added vi motions *, #, {, } and yank-to-end-of-line on Y, per the official CHANGELOG.

Vi mode is the feature that turns Alacritty's minimalism into an advantage: with no GUI search bar to reach for, the keyboard-only scrollback workflow is faster than the mouse once it is in your fingers.

Why Does Alacritty Have No Tabs? (And Why Is That a Feature)

It is deliberate, and it is the whole point. Alacritty explicitly does not support tabs or splits; multiplexing is outsourced to a terminal multiplexer like tmux, per the "integrating with other applications, rather than reimplementing their functionality" design rule. A common practitioner pattern is to start alacritty -e tmux and manage every split with tmux shortcuts, keeping the emulator simple and the multitasking model identical on every machine.

If you want the multiplexer built into the terminal instead, that is a different lane — our WezTerm guide covers the terminal that ships multiplexing natively. Alacritty's answer is philosophical: one tool, one job.

What Should $TERM Be Set To in Alacritty?

Leave it alone on any machine with the alacritty terminfo installed: Alacritty advertises TERM=alacritty by default, and falls back to xterm-256color where its terminfo entry is missing. The official default-config comment documents exactly this behavior.

There is a third option for modern setups: alacritty-direct, available since 0.13.0, which explicitly advertises 24-bit (direct) color support while keeping most of Alacritty's feature set. And if you SSH into an older server and colors look wrong, that is usually the missing terminfo on the remote end — the fallback to xterm-256color is the safe setting there. The 0.17.0 release also removed a broken flash capability from the terminfo entry (official CHANGELOG).

How Do You Install a Color Theme?

Clone the official theme collection and import one file — that is the whole procedure. The alacritty-theme repository ("Collection of colorschemes for easy configuration of the Alacritty terminal emulator", ~2,964 stars, themes in a themes/ directory; computingforgeeks reported 177 themes in the collection in October 2026) documents this verbatim:

# We use Alacritty's default Linux config directory as our storage location here.
mkdir -p ~/.config/alacritty/themes
git clone https://github.com/alacritty/alacritty-theme ~/.config/alacritty/themes

Then, in your alacritty.toml:

[general]
import = [
    "~/.config/alacritty/themes/themes/{theme}.toml"
]

Replace {theme} with the scheme you want (or paste a theme's full content into the root of your config file). Per the official config reference, imports load in order, missing files are skipped, and the importing file itself loads last — so anything you set after the import wins.

Alacritty vs Ghostty vs WezTerm vs Kero: Which Lane Is Yours?

Pick Alacritty for the minimal lane: a GPU-accelerated window, one TOML file, and tmux for everything else. Its siblings trade minimalism for built-in features, and each owns a different lane on this site — none of them is "the best", they are answers to different workflows:

Sources

Alacritty releases / CHANGELOG — github.com/alacritty/alacritty/releases (fetched 2026-11-04); Alacritty 0.17 coverage — Linuxiac, 7 April 2026; Alacritty overview — Wikipedia (fetched 2026-11-04); alacritty(1) / alacritty(5) / alacritty-bindings(5) man pages — man.archlinux.org (fetched 2026-11-04); vi mode docs — official docs/features.md via the Alacritty repo mirror (fetched 2026-11-04); alacritty-theme — github.com/alacritty/alacritty-theme (fetched 2026-11-04); install guides — computingforgeeks and computingforgeeks multi-OS guide (fetched 2026-11-04); Fedora install — idroot.us (fetched 2026-11-04); comparison context — bundl.run, October 2026; tmux pairing pattern — copyprogramming (fetched 2026-11-04).

Frequently Asked Questions

What format is the Alacritty config file?

TOML, since version 0.13.0 (January 2024). If you have an old alacritty.yml, run alacritty migrate to convert it to alacritty.toml.

Does Alacritty have tabs or split panes?

No — deliberately. Alacritty explicitly does not support tabs or splits; pair it with tmux (for example alacritty -e tmux) for panes, sessions, and persistence.

How do I make the text bigger or smaller in Alacritty?

Ctrl+= increases the font size, Ctrl+- decreases it, and Ctrl+0 resets it to the configured size. To change the default, set size in the [font] table of your config.

Is Alacritty faster than Ghostty?

Both are GPU-accelerated terminal emulators, and no credible head-to-head benchmark was found for this article — choose on workflow, not claimed speed. Alacritty is the minimal lane; Ghostty trades minimalism for built-in conveniences.

Why do colors look wrong when I SSH from Alacritty?

The remote machine usually lacks the alacritty terminfo entry, so applications misread its capabilities. Alacritty falls back to xterm-256color where its own entry is missing; installing the alacritty terminfo on the remote end (or using that fallback) fixes it.