Cheat Sheet logoCheat Sheet Today

tmux Troubleshooting and Debugging

tmux•Permalink

tmux commands and config snippets for diagnosing key bindings, options, environment issues, TERM problems, and server resets.

Sign in to save
View
StandardDetailedCompact
Export
Copy the compact sheet, download it, or print it.
Download
`D` dense toggle · `C` copy all
## Debug and introspection
Show global options
↗#
tmux show-options -g

# Inspect current global configuration.

Show window options
↗#
tmux show-window-options -g

# Inspect per-window settings.

List key bindings
↗#
tmux list-keys

# Dump the default and custom key tables.

Show tmux environment
↗#
tmux show-environment

# Inspect environment variables known to tmux.

Show server info
↗#
tmux info

# Print internal server details.

## Common problems and fixes
Set a modern default terminal
↗#
set -g default-terminal "tmux-256color"

# Use a terminal definition with 256-color/feature support.

Preserve selected environment variables
↗#
set -g update-environment "DISPLAY SSH_AUTH_SOCK SSH_AGENT_PID WINDOWID XAUTHORITY"

# Update tmux with variables from the client environment.

Restart the tmux server
↗#
tmux kill-server

# Terminate the tmux server entirely.

Reload config with shell tracing
↗#
sh -x -c "tmux source-file ~/.tmux.conf"

# Verify config sourcing from a shell wrapper.

More in tmux

tmux Plugins and Productivity Setup
tmux plugin manager patterns, TPM setup, and common plugin snippets for restoring sessions, sensible defaults, and clipboard workflows.
tmux Remote Sessions, SSH, and Pairing
tmux patterns for remote servers, resilient SSH sessions, multi-client visibility, and collaboration workflows.
tmux Scripting, Formats, and Automation
tmux commands for listing state, using format strings, conditional logic, send-keys automation, and repeatable workspace bootstrapping.
tmux Configuration and Customization
tmux .tmux.conf settings for prefix changes, mouse support, indexing, reloading, and status bar customization.
tmux Copy Mode, Scrollback, and Clipboard
tmux copy-mode commands, scrollback capture, search, buffers, and clipboard configuration patterns.
tmux Sessions, Windows, and Panes
Core tmux commands and interactive shortcuts for managing sessions, windows, panes, splits, and layouts.

Recommended next

No recommendations yet.
Browse all sheets →