Alacritty - A fast, cross-platform, OpenGL terminal emulator.
Contents
Bugs
Found a bug? Please report it at https://github.com/alacritty/alacritty/issues.
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.
Maintainers
• Christian Duerr <contact@christianduerr.com>
• Kirill Chibisov <contact@kchibisov.com>
2025-04-12 ALACRITTY(1)
Name
Alacritty - A fast, cross-platform, OpenGL terminal emulator.
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
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.
See Also
alacritty-msg(1), alacritty(5), alacritty-bindings(5)
Subcommands
msg
Send IPC socket messages (see alacritty-msg(1)).
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.
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.
