default_domain = "local"¶
Since: Version 20220319-142410-0fcdea07
The functionality described in this section requires version 20220319-142410-0fcdea07 of wezterm, or a more recent version.
This option only applies to the GUI. For the equivalent option in the standalone mux server, see default_mux_server_domain
When starting the GUI (not using the
connect subcommands), by default wezterm will set the built-in
"local" domain as the default multiplexing domain.
"local" domain represents processes that are spawned directly on the local system.
Windows users, particularly those who use
WSL, may wish to override
the default domain to instead use a particular WSL distribution so that wezterm
launches directly into a Linux shell rather than having to manually invoke
wsl.exe. Using a WslDomain for this has the advantage
that wezterm can then use shell integration to
track the current directory inside WSL and use it when splitting new panes or
spawning new tabs.
For example, if:
then wezterm will by default create a
WslDomain with the name
and if I set my config like this:
then when wezterm starts up, it will open with a shell running inside that Ubuntu
distribution rather than using the default
While these examples are WSL-centric,
default_domain will accept the name
of any of the available multiplexing domains.