wezterm/docs/config/lua/WslDomain.md

WslDomain

Since: 20220319-142410-0fcdea07

The WslDomain struct specifies information about an individual WslDomain, which is used to tell wezterm how to interact with one of your locally installed WSL distributions.

By mapping a distribution to a multiplexing domain, wezterm is better able to support creating new tabs and panes with the same working directory as an existing tab/pane running in that same domain.

By default, wezterm creates a list of WslDomain objects based on parsing the output from wsl -l -v and assigns that as the value of the wsl_domains configuration option.

A WslDomain is a lua object with the following fields:

{
  -- The name of this specific domain.  Must be unique amonst all types
  -- of domain in the configuration file.
  name = "WSL:Ubuntu-18.04",

  -- The name of the distribution.  This identifies the WSL distribution.
  -- It must match a valid distribution from your `wsl -l -v` output in
  -- order for the domain to be useful.
  distribution = "Ubuntu-18.04",


  -- The username to use when spawning commands in the distribution.
  -- If omitted, the default user for that distribution will be used.

  -- username = "hunter",


  -- The current working directory to use when spawning commands, if
  -- the SpawnCommand doesn't otherwise specify the directory.

  -- default_cwd = "/tmp"


  -- The default command to run, if the SpawnCommand doesn't otherwise
  -- override it.  Note that you may prefer to use `chsh` to set the
  -- default shell for your user inside WSL to avoid needing to
  -- specify it here

  -- default_prog = {"fish"}
}