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

alacritty [FLAGS] [OPTIONS]

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

--class <instance> | <instance>,<general>
Defines the window class hint on Linux [default: Alacritty,Alacritty]

On Wayland the instance class sets the `app_id`, while the general class is ignored.

-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.yml 2. $XDG_CONFIG_HOME/alacritty.yml 3. $HOME/.config/alacritty/alacritty.yml 4. $HOME/.alacritty.yml

On Windows, the configuration file is located at %APPDATA%\alacritty\alacritty.yml.

--embed <parent>
Defines the X11 window ID (as a decimal integer) to embed Alacritty within
-o, --option <option>...
Override configuration file options [example:]
-t, --title <title>
Defines the window title [default: Alacritty]
--working-directory <working-directory>
Start the shell in the specified working directory

See the alacritty github repository at for the full documentation.

Found a bug? Please report it at

•Christian Duerr <>

•Joe Wilm <>

August 2018 alacritty 0.7.2