tmuxtmuxOptions, hooks and formats

Choose documentation 1

latest

tmux catalog version

Latest (3.7c) 3.7c 3.2a
English

option tmux3.7c

default-shell

Specify the default shell.

Scope
session
Type
Text
Default
/bin/sh
Set
set-option default-shell value
Read
show-options default-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:603
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
Esc

Type to search.

Reference preview Open reference