What is tmux?
tmux is the terminal multiplexer: it runs many shells inside one terminal, split into windows and panes, and keeps them running after you disconnect. A tmux session lives in a server process, not in your terminal window, so you can detach from it, close the window or lose the ssh connection, and attach to it again later with every program still running exactly where you left it. Inside a session you open windows like tabs, split each one into panes side by side or on top of each other, scroll back and copy text with the keyboard, and drive all of it from a config file or from scripts. tmux is written in C, started by Nicholas Marriott, and is ISC licensed.
apt upgrade.
⚡ Key Features of tmux
🔌 Detach and Reattach
Start a long build or a server process inside tmux, detach, log out or lose the network, and attach again from anywhere: the session and everything in it kept running while you were gone.
🪟 Windows and Panes
Each session holds windows like tabs, and each window splits into panes, so an editor, a shell and a log tail share one screen. Panes resize, zoom to full size and rearrange with a few keys.
🎈 Floating and Modal Panes
tmux 3.8 adds floating panes that sit above the layout and modal panes that take over the window until you close them, for a quick command or a picker without disturbing your splits.
📋 Copy Mode and Clipboard
Scroll back through a pane's history, search it and select text with vi or emacs keys. Copied text reaches your desktop clipboard through OSC 52, even from a tmux running on a remote server.
🖼️ Images in the Terminal
This build has sixel support enabled, so programs that draw sixel images show them inside a tmux pane when your terminal supports sixel too.
🧰 Scriptable and Configurable
Every action is a command: bind it to a key in ~/.tmux.conf, or run it from a shell script to build a whole session layout in one go. Plugin managers and session tools build on exactly that.
apt upgrade keeps you on the latest version.
📦 Installation from deb.griffo.io
Step 1: Add Repository
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(. /etc/os-release; echo ${DEBIAN_CODENAME:-${UBUNTU_CODENAME:-$VERSION_CODENAME}}) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(. /etc/os-release; echo ${DEBIAN_CODENAME:-${UBUNTU_CODENAME:-$VERSION_CODENAME}}) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt update🆓 There is an always-free mirror. deb-free.griffo.io serves packages free forever, no account, no subscription, at most 2 months behind upstream, security fixes immediately. It currently carries cliamp, Forgejo Runner, Ghostty, lazydocker, Oh My Posh, Uncloud and Zed; tmux is not one of them, so the repository above is the only way to get it today, ask and it can be enrolled.
Step 2: Install tmux
# Install latest tmux (replaces the distribution's older tmux in place)
sudo apt install tmux
# Verify installation
dpkg -s tmux | grep Version# Install latest tmux (replaces the distribution's older tmux in place)
apt install tmux
# Verify installation
dpkg -s tmux | grep VersionStep 3: First run
# Upgraded from the distribution's tmux? Sessions that were already running
# keep the old server until you exit them; this stops them all at once
tmux kill-server
# Start a named session
tmux new -s work
# Detach with Ctrl-b d, then attach again later, from here or over ssh
tmux attach -t work🎯 Basic Usage Examples
Sessions, windows and panes:
# List the running sessions
tmux ls
# Inside tmux, the prefix is Ctrl-b, followed by:
# c new window n / p next / previous window
# % split left/right " split top/bottom
# arrows move between panes z zoom the current pane
# [ copy mode, to scroll back and select text
# d detachScripting a layout:
# A detached session with an editor on the left and a shell on the right
tmux new-session -d -s dev -n code
tmux split-window -h -t dev:code
tmux send-keys -t dev:code.0 'nvim' Enter
tmux attach -t dev
# Reload your configuration without restarting anything
tmux source-file ~/.tmux.confKeeping it current:
# tmux updates with the rest of the system
sudo apt update && sudo apt upgrade
# Which version is installed, and which is the newest available
apt policy tmux
# Running sessions keep the old server; exit them or stop it to switch
tmux kill-server# tmux updates with the rest of the system
apt update && apt upgrade
# Which version is installed, and which is the newest available
apt policy tmux
# Running sessions keep the old server; exit them or stop it to switch
tmux kill-server🔧 Tool Integrations
Because the package is called tmux, everything built on tmux keeps working after the upgrade:
- ssh: run tmux on the server, not on your laptop, and a dropped connection only detaches you;
ssh -t host tmux attachpicks the session up again - Plugins: tmux-plugin-manager (tpm) and the plugins it installs load from
~/.tmux.confexactly as before - Session tools: tmuxinator and byobu drive the
tmuxcommand, so they get the new version with nothing to reconfigure - Clipboard: with OSC 52, text copied in copy mode reaches the clipboard of the terminal you are sitting at, even through ssh
- Terminal features: ncurses 6.6 is linked statically, so the clipboard, cursor colour and style, and styled underlines behave the same on every supported release
- systemd: built with systemd support, like the distribution's own package, and its sockets in
/tmpare kept safe fromsystemd-tmpfilescleanup the same way - Documentation: the tmux wiki at github.com/tmux/tmux/wiki covers getting started, the FAQ and every option
🚀 Why Choose deb.griffo.io?
- Official Ubuntu: ships tmux 3.6a in 26.04 and 3.4 in Noble, each frozen for the life of its release
- Upstream downloads: tmux publishes source only, so there is no ready-made binary to download for any release
- Building from source: a C toolchain plus the libevent and ncurses development packages, a configure and make for every release, and nothing that updates it for you
- deb.griffo.io: latest version with automatic updates
- ✅ Same Package Name as Ubuntu: the package is
tmux, exactly what the Ubuntu archive calls it, so this repository upgrades the stock tmux in place onapt upgrade - ✅ Built From Every Tagged Release: compiled from the release tarball with systemd, jemalloc and sixel image support enabled, like the distribution's own build, and registered in
/etc/shells - ✅ One tmux From Jammy to Resolute: the same release on every supported Ubuntu, so one
~/.tmux.confbehaves the same on all your machines - ✅ Automatic Updates: packages updated within hours of upstream releases
- ✅ Two Architectures: amd64 and arm64 on every suite, so the same tmux runs on servers, laptops and ARM boards like the Raspberry Pi
- ✅ Multi-Distribution: works on Ubuntu 22.04, 24.04, 25.10 and 26.04
- ✅ Easy Maintenance: standard apt commands for updates
📦 Package Build Repository
The Ubuntu packages are automatically built and maintained in this GitHub repository:
- 🔳 tmux-debian - Latest release builds
🔗 Related Packages
Also available from deb.griffo.io:
- Zellij - A terminal workspace and multiplexer in Rust, with layouts and plugins
- workmux - git worktrees and tmux windows as isolated dev environments
- kitty - A fast, GPU based terminal emulator to run tmux in
- Neovim - The editor most often found in a tmux pane
- fish - A friendly interactive shell for every pane
💝 Support This Project
If this repository saves you time and effort, please consider supporting it!
