Your company here, and a link to your site. Click to find out more.

alacritty - Man Page

A fast, cross-platform, OpenGL terminal emulator.

Examples (TL;DR)


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.


-h,  --help

Prints help information.


Remain open after child process exits.


Print all events to STDOUT.


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


Generates ref test


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

-V,  --version

Prints version information.



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 looks for the configuration file at the following paths:

  1. $XDG_CONFIG_HOME/alacritty/alacritty.toml
  2. $XDG_CONFIG_HOME/alacritty.toml
  3. $HOME/.config/alacritty/alacritty.toml
  4. $HOME/.alacritty.toml

On Windows, the configuration file is located at %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.



Send IPC socket messages (see alacritty-msg(1)).


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.


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(5), alacritty-bindings(5)


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


Referenced By

alacritty(5), alacritty-bindings(5), alacritty-msg(1), xde-menu(1).