How to List Sessions in Tmux [3 Effective Ways]

Written by

Reviewed by

Last updated: June 25, 2023

Expert verified

SVG Image


To list sessions in Tmux, you can try these three methods:

  1. Use the command tmux list-sessions in the Terminal to quickly list active Tmux sessions.
  2. Press Ctrl-b followed by s within a Tmux session to access a session selection menu and switch between sessions.
  3. Press Ctrl-b followed by : to enter the Tmux command prompt, then enter the command list-sessions to view active sessions.

Encountering common errors when listing Tmux sessions can hinder your workflow. Be prepared to troubleshoot issues like “No sessions found,” “Unknown command list-sessions,” Tmux not being installed or in PATH, and insufficient permissions. By understanding these errors and their solutions, you can overcome them and successfully list Tmux sessions without interruption.

Continue reading the article below to discover three methods to list sessions in Tmux and common errors that can occur when listing sessions.

Session listing is a crucial feature of Tmux that allows you to manage and organize your Terminal sessions effortlessly. It lets you view all your active sessions at a glance, switch between them seamlessly, and even share sessions with other users. With the ability to list sessions in Tmux, you gain complete control over your Terminal environment, enhancing your productivity and making your workflow more efficient. In this guide, I will explore different methods to list Tmux sessions, providing step-by-step instructions and valuable insights. I will also discuss some common errors that can occur when listing sessions.

How to List Sessions in Tmux

To list sessions in Tmux in Linux, you have multiple options: the command line method, the Tmux shortcut, or accessing the Tmux command prompt. Using the command line, enter tmux list-sessions to display active sessions. With the Tmux shortcut, press Ctrl-b, followed by s, to open a session selection menu. To access the Tmux command prompt, press Ctrl-b, then type :, and enter list-sessions.

1. Command Line

Using the command line to list Tmux sessions is quick and straightforward. This method is ideal for users who prefer a command-driven approach or need to incorporate session listing into scripts or automation workflows. Follow these steps to list sessions in Tmux:

  1. Open your Terminal by pressing Ctrl+Alt+T.
opening terminal
  1. Enter the following command:
<strong>tmux list-sessions</strong>
  1. The Terminal will list all active Tmux sessions, including their session IDs and attached clients.
listing all active tmux sessions 1

2. Tmux Shortcut

The Tmux shortcut provides a convenient way to list sessions while working within a Tmux session. This method is useful when you are already inside a Tmux session and want to quickly switch to a different session without leaving your current Terminal environment. Here are the steps to do it:

  1. Start or attach to a Tmux session. While inside the Tmux session, press Ctrl-b. This will activate the Tmux command prompt.
  2. Release Ctrl-b and then press s.
pressing keys to open session selection menu
  1. A session selection menu will appear, showing all available Tmux sessions. Use the arrow keys to navigate through the list of sessions. Once you have highlighted the desired session, press Enter to select it.
opening session selection menu to choose session

3. Tmux Command Prompt

Accessing the Tmux command prompt allows you to execute Tmux commands directly and efficiently. This method is beneficial when you want to interact with Tmux through a dedicated prompt, enabling you to list sessions and perform other Tmux operations seamlessly. Follow these steps:

  1. Attach to a Tmux session and press Ctrl-b to activate the Tmux command prompt.
  2. Release Ctrl-b and then type :. The command prompt will now be ready to accept Tmux commands.
  3. Enter the following command to list sessions:
<strong>list-sessions </strong>
opening sessions list using tmux command prompt
  1. Tmux will list all active sessions, including their session IDs and attached clients.
displaying list of active sessions

4 Common Errors for Listing Sessions in Tmux

When listing Tmux sessions, it’s possible to encounter a few common errors. By being aware of these common errors and their solutions, you can troubleshoot and overcome any issues you may encounter while attempting to list Tmux sessions effectively. Here are four errors you may come across and their possible solutions:

  • 💡“No sessions found”: This error occurs when listing Tmux sessions, but no active sessions are available. It typically happens when Tmux has not started or all existing sessions have been terminated. To resolve this error, you can start a new Tmux session using the tmux new-session command or check for existing sessions using commands like tmux list-sessions or tmux ls to ensure that there are active sessions before attempting to list them.
  • “Unknown command list-sessions”: If you encounter the error message “Unknown command ‘list-sessions'”, it suggests that Tmux does not recognize the command you used to list sessions. This issue can occur due to a typo in the command or if you are using an outdated version of Tmux that does not support the specific command. Double-check the command syntax, ensuring proper capitalization and spacing. Additionally, consult the Tmux documentation or use alternative commands such as ls or list-s that may be compatible with your Tmux version.
  • ⚠️ Tmux not installed or not in PATH: This error occurs when Tmux is not installed on your system, or the Tmux executable is not in the system’s PATH variable. Ensure that Tmux is installed using the appropriate package manager for your operating system. If Tmux is already installed, verify that the Tmux executable is added to the system’s PATH variable, which allows the system to locate and execute the Tmux command. If necessary, modify your PATH variable or consult the documentation for your operating system on how to set the PATH correctly.
  • 🔒 Insufficient permissions: When encountering an “insufficient permissions” error, it indicates that the user running the command does not have the necessary permissions to access or interact with Tmux sessions. This error can arise if the user does not have the appropriate rights to execute Tmux commands or access the Tmux socket files. To resolve this issue, ensure that the user has the required permissions. If available, you can try running the Tmux commands with elevated privileges using sudo or other administrative tools. If you’re working in a shared environment or on a managed system, contact the system administrator for assistance in obtaining the necessary permissions.

To Sum Up

This comprehensive guide has provided various methods for listing Tmux sessions. As you continue to explore Tmux and its functionalities, it’s important to be aware of common errors that may arise. I have also discussed some common mistakes that can occur while listing sessions.

To further enhance your Tmux skills, consider exploring advanced Tmux configurations, innovative Tmux plugins, or efficient workflow strategies using Tmux session management tools. Continuously refining your Tmux skills will allow you to harness its full potential, unlocking new possibilities in your command-line workflow.

Frequently Asked Questions

How can I rename a Tmux session?

To rename a Tmux session, switch to the desired session and use the command tmux rename-session new_name. This allows you to give your session a more descriptive or meaningful name. Renaming sessions can be helpful when you want to identify and manage your sessions easily. Remember to list the sessions using tmux list-sessions or tmux ls to verify the updated name.

Is it possible to share a Tmux session with other users?

Yes, you can share a Tmux session with other users. Using the session attaching feature, multiple users can connect to the same session simultaneously. To share a Tmux session, start with tmux new-session -s session_name or attach to an existing session with tmux attach-session -t session_name. Share the session name with others who want to join, and they can attach to the session using tmux attach-session -t session_name in their own Terminals.

Can I customize the appearance of Tmux session status bars?

Absolutely! Tmux allows you to customize the appearance of session status bars. You can modify the status bar colors, display additional information, or create custom themes. To customize the status bars, edit the Tmux configuration file (~/.tmux.conf) and add directives for colors, information display, or theme customization. With these customization options, you can create a personalized and visually appealing status bar that suits your preferences and enhances your Tmux experience.



Ojash is a skilled Linux expert and tech writer with over a decade of experience. He has extensive knowledge of Linux's file system, command-line interface, and software installations. Ojash is also an expert in shell scripting and automation, with experience in Bash, Python, and Perl. He has published numerous articles on Linux in various online publications, making him a valuable resource for both seasoned Linux users and beginners. Ojash is also an active member of the Linux community and participates in Linux forums.



Akshat is a software engineer, product designer and the co-founder of Scrutify. He's an experienced Linux professional and the senior editor of this blog. He is also an open-source contributor to many projects on Github and has written several technical guides on Linux. Apart from that, he’s also actively sharing his ideas and tutorials on Medium and Attirer. As the editor of this blog, Akshat brings his wealth of knowledge and experience to provide readers with valuable insights and advice on a wide range of Linux-related topics.

Share this article
Shareable URL
Prev Post

How to Kill Sessions in Tmux [4 Best Methods]

Next Post

5 Easy Ways to Check CPU Clock Speed on Linux

Leave a Reply

Your email address will not be published. Required fields are marked *

Read next