option tmux3.2a
default-shell
Specify the default shell.
- Scope
- session
- Type
- Text
- Default
/bin/sh- Set
-
set-optiondefault-shell value - Read
-
show-optionsdefault-shell
Description#
Specify the default shell. This is used as the login shell for new windows when the
default-command option is set to empty, and must be the full path of the executable. When started tmux tries to set a default value from the first suitable of the SHELL environment variable, the shell returned by getpwuid(3), or /bin/sh. This option should be configured when tmux is used as a login shell.Releases#
Source#
- Defined in
options-table.c:390- C source reference
options_table- CLI Manual
- Original manual entry
Used by#
Library documentation that names this option.
- Python
libtmux_mcp.tools.option_tools.set_option,tmuxp.workspace.options.PaneReadiness,tmuxp.workspace.options.resolve_session_shell- TypeScript
server.Server.showGlobalOptions- Rust
freeze.freeze,options.generated.DEFAULT_SHELL- Go
tmux.GlobalSessionScope.SetDefaultShell,tmux.Session.Run,tmux.Session.SetDefaultShell,tmux.SessionOptionValues.DefaultShell