Arch manual pages


alacritty - a cross-platform, gpu-accelerated terminal emulator

alacritty [FLAGS] [OPTIONS]

Alacritty is a terminal emulator with a strong focus on simplicity and performance. With such a strong focus on performance, included features are carefully considered and you can always expect Alacritty to be blazingly fast. By making sane choices for defaults, Alacritty requires no additional setup. However, it does allow configuration of many aspects of the terminal.

-h, --help
Prints help information
Remain open after child process exits
Enable automatic config reloading
Disable automatic config reloading
Keep the log file after quitting Alacritty
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.

-d, --dimensions <columns> <lines>
Defines the window dimensions. Falls back to size specified by window manager if set to 0x0 [default: 0x0]
--position <x-pos> <y-pos>
Defines the window position. Falls back to position specified by window manager if unset [default: unset]
-t, --title <title>
Defines the window title [default: Alacritty]
--embed <parent>
Defines the X11 window ID (as a decimal integer) to embed Alacritty within
--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.5.0