---
name: "alacritty"
section: "1"
platform: "linux"
package: "alacritty"
version: "0.17.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/alacritty"
---

# alacritty(1)

A fast, cross-platform, OpenGL terminal emulator.

## NAME

Alacritty - A fast, cross-platform, OpenGL terminal emulator.

## SYNOPSIS

Alacritty is a modern terminal emulator that comes with sensible defaults, but allows for extensive configuration. By integrating with other applications, rather than reimplementing their functionality, it manages to provide a flexible set of features with high performance.

## FLAGS

**-h, --help**

Prints help information.

**--hold**

Remain open after child process exits.

**--daemon**

Do not spawn an initial window.

**--print-events**

Print all events to STDOUT.

**-q**

Reduces the level of verbosity (the min level is **-qq**).

**--ref-test**

Generates ref test

**-v**

Increases the level of verbosity (the max level is **-vvv**).

**-V, --version**

Prints version information.

## OPTIONS

**--class** *\<GENERAL\>* \| *\<GENERAL\>*,*\<INSTANCE\>*

Defines the window class hint on Linux.

When only the general class is passed, instance will be set to the same value.

On Wayland the general class sets the *app\_id*, while the instance class is ignored.

Default: *Alacritty,Alacritty*

- **-e, --command** *\<COMMAND\>...*

  Command and args to execute (must be last argument).

- **--config-file** *\<CONFIG\_FILE\>*

  Specify alternative configuration file.

  Alacritty doesn't create the config file for you, but it looks for one in the following locations on UNIX systems:

  - 1\.

    *$XDG\_CONFIG\_HOME/alacritty/alacritty.toml*

  - 2\.

    *$XDG\_CONFIG\_HOME/alacritty.toml*

  - 3\.

    *$HOME/.config/alacritty/alacritty.toml*

  - 4\.

    *$HOME/.alacritty.toml*

  - 5\.

    */etc/alacritty/alacritty.toml*

  On Windows, the config file will be looked for in:

  - 1\.

    *%APPDATA%\\alacritty\\alacritty.toml*

- **--embed** *\<PARENT\>*

  X11 window ID to embed Alacritty within (decimal or hexadecimal with *0x* prefix).

- **-o, --option** *\<OPTION\>...*

  Override configuration file options.

  Example: *alacritty -o 'cursor.style="Beam"'*

- **--socket** *\<SOCKET\>*

  Path for IPC socket creation.

- **-T, --title** *\<TITLE\>*

  Defines the window title.

  Default: *Alacritty*

- **--working-directory** *\<WORKING\_DIRECTORY\>*

  Start the shell in the specified working directory.

## SUBCOMMANDS

**msg**

Send IPC socket messages (see [**alacritty-msg**(1)](/alacritty-msg/1.md)).

**migrate**

Migrate the configuration file.

**-c, --config-file** *\<CONFIG\_FILE\>*

Path to the configuration file.

**-d, --dry-run**

Only output TOML config to STDOUT.

**-i, --skip-imports**

Do not recurse over imports.

**--skip-renames**

Do not move renamed fields to their new location.

**-s, --silent**

Do not output to STDOUT.

**-h, --help**

Print help information.

## SEE ALSO

[**alacritty-msg**(1)](/alacritty-msg/1.md), [**alacritty**(5)](/alacritty/5.md), [**alacritty-bindings**(5)](/alacritty-bindings/5.md), **alacritty-escapes**(7)

## BUGS

Found a bug? Please report it at *https://github.com/alacritty/alacritty/issues*.

## MAINTAINERS

- •

  Christian Duerr \<contact@christianduerr.com\>

- •

  Kirill Chibisov \<contact@kchibisov.com\>