Software⏱️ 1 min read📅 2026-06-03

How to Fix: "tmux set -g mouse-mode on" not scrolling

tmux mouse-mode issue

Quick Answer: Check if you have a conflicting mouse mode setting, such as `set -g mouse-sync` or `bind-key 'M-mouse-wheel' send-keys 'mouse-wheel'`, and remove it. If that doesn't work, try restarting tmux or running `source ~/.tmux.conf` to apply the changes.

To allow scrolling a tmux pane with a mouse, you need to set both `mouse-mode` and `mode-option` in your ~/.tmux.conf file. The issue arises when only `mouse-mode` is enabled without specifying the mode option.

✅ Best Solutions to Fix It

Method 1: Enable Mouse Mode and Mode Option

  1. Step 1: Add the following lines to your ~/.tmux.conf file:
set -g mouse-mode on
set -g mode-option 'scroll-wheel' on

✨ Example: Update Your .tmux.conf File

After adding these lines, restart your tmux session or run source ~/.tmux.conf to apply the changes.

Did this fix your problem?

If not, try searching for specific error codes.

🔍 Search Error Database

❓ Frequently Asked Questions

🛠️ Related Fixes

How to Fix: Pc crashes shortly after launching game (rainbow

Fix Pc crashes shortly after launching game (rainbow six siege). Compl

How to Fix: Installing an APK on a locked down phone

Installing an APK on a locked down phone: Try using a rooted device, e

How to Fix: New PC build- no signal and no clue

Fix New PC build- no signal and no clue. Complete troubleshooting guid