Use this cheat sheet for tmux as a terminal multiplexer

Get to know tmux, an application that lets you open multiple terminals in a single desktop window.
71 readers like this.
Windows

PixelAnarchy on Pixabay, CC0.

Whether you're starting up an elaborate Raspberry Pi homelab or you're managing a building full of workstations, sometimes you need to do the same task on multiple hosts. There are many ways to automate tasks across systems. Ansible, for instance, ensures all systems are in the same state, and sometimes a simple cron job will do. But sometimes you need to run commands manually. For that, you need tmux, a single terminal that puts you in control of multiple command prompts.

tmux is an open source application that adds layers (or "windows," in tmux terminology) to your terminal window so that you can open more than one terminal in a single desktop window. The result is a tabbed interface (without the physical tabs), so you can flip from one open terminal to another without having to use the mouse the way you have to when switching from one tab in Firefox to another.

This might seem redundant. After all, modern terminal applications, such as GNOME Terminal and Konsole, have tabs built-in by default, and even some very old terminals, such as rxvt, have the ability to add a tabbed interface. However, tmux adds in the ability to split a window into panes, with each pane containing a separate terminal, and each terminal can be logged into a separate host. You can build an array of terminals with just a few keyboard shortcuts or a rudimentary tmuxinator script.

(Seth Kenlon, CC BY-SA 4.0)

Install tmux

On Linux and BSD, you can install tmux from your software repository or ports tree. On Mac, use Homebrew.

For example, on RHEL or Fedora:

$ sudo dnf install tmux

Start tmux

To start tmux, open a terminal and type:

$ tmux

When you do this, the obvious result is that tmux launches a new shell in the same window with a status bar along the bottom. There's more going on, though, and you can see it with this little experiment. First, do something in your current terminal to help you tell it apart from another empty terminal:

$ echo hello
hello

Now press Ctrl+B followed by C on your keyboard. It might look like your work has vanished, but actually, you've created what tmux calls a window (which can be, admittedly, confusing because you probably also call the terminal you launched a window). Thanks to tmux, you actually have two windows open, both of which you can see listed in the status bar at the bottom of tmux. You can navigate between these two windows by index number. For instance, press Ctrl+B followed by 0 to go to the initial window:

$ echo hello
hello

Press Ctrl+B followed by 1 to go to the first new window you created.

You can also "walk" through your open windows using Ctrl+B and N (for Next) or P (for Previous).

The tmux trigger and commands

The keyboard shortcut Ctrl+B is the tmux trigger. When you press it in a tmux session, it alerts tmux to "listen" for the next key or key combination that follows. All tmux shortcuts, therefore, are prefixed with Ctrl+B.

You can also access a tmux command line and type tmux commands by name. For example, to create a new window the hard way, you can press Ctrl+B followed by : to enter the tmux command line. Type new-window and press Enter to create a new window. This does exactly the same thing as pressing Ctrl+B then C.

Splitting windows into panes

Once you have created more than one window in tmux, it's often useful to see them all in one window. You can split a window horizontally (meaning the split is horizontal, placing one window in a North position and another in a South position) or vertically (with windows located in West and East positions).

  • To create a horizontal split, press Ctrl+B followed by " (that's a double-quote).
  • To create a vertical split, press Ctrl+B followed by % (percent).

You can split windows that have been split, so the layout is up to you and the number of lines in your terminal.

Sometimes things can get out of hand. You can adjust a terminal full of haphazardly split panes using these quick presets:

  • Ctrl+B Alt+1: Even horizontal splits
  • Ctrl+B Alt+2: Even vertical splits
  • Ctrl+B Alt+3: Horizontal span for the main pane, vertical splits for lesser panes
  • Ctrl+B Alt+3: Vertical span for the main pane, horizontal splits for lesser panes
  • Ctrl+B Alt+5: Tiled layout

Switching between panes

To get from one pane to another, press Ctrl+B followed by O (as in other). The border around the pane changes color based on your position, and your terminal cursor changes to its active state. This method "walks" through panes in order of creation.

Alternatively, you can use your arrow keys to navigate to a pane according to your layout. For example, if you've got two open panes divided by a horizontal split, you can press Ctrl+B followed by the Up arrow to switch from the lower pane to the top pane. Likewise, Ctrl+B followed by the Down arrow switches from the upper pane to the lower one.

Running a command on multiple hosts with tmux

Now that you know how to open many windows and divide them into convenient panes, you know nearly everything you need to know to run one command on multiple hosts at once. Assuming you have a layout you're happy with and each pane is connected to a separate host, you can synchronize the panes such that the input you type on your keyboard is mirrored in all panes.

To synchronize panes, access the tmux command line with Ctrl+B followed by :, and then type setw synchronize-panes.

Now anything you type on your keyboard appears in each pane, and each pane responds accordingly.

Download our cheat sheet

It's relatively easy to remember Ctrl+B to invoke tmux features, but the keys that follow can be difficult to remember at first. All built-in tmux keyboard shortcuts are available by pressing Ctrl+B followed by ? (exit the help screen with Q). However, the help screen can be a little overwhelming for all its options, none of which are organized by task or topic. To help you remember the basic features of tmux, as well as many advanced functions not covered in this article, we've developed a tmux cheatsheet. It's free to download, so get your copy today.

Download our tmux cheat sheet today!

What to read next
Tags
Seth Kenlon
Seth Kenlon is a UNIX geek, free culture advocate, independent multimedia artist, and D&D nerd. He has worked in the film and computing industry, often at the same time.

Comments are closed.

Creative Commons LicenseThis work is licensed under a Creative Commons Attribution-Share Alike 4.0 International License.