tmux-fingers/docs/health-check.md

# Health check troubleshooting

*tmux-fingers* performs a health check on startup to ensure that your system has all dependencies needed to run smoothly.

They are not much, and in most GNU/linux environments these are the defaults anyway.

## gawk not found

Install `gawk` package.

### OSX

`$ brew install gawk`

### Linux

* Ubuntu: `$ sudo aptitude install gawk`
* Arch linux: `$ sudo pacman -S install gawk`

## bash version is too old

This probably means you are running OSX, which ships with *bash 3*. In order to upgrade to *bash 4* you need need to run:

`$ brew install bash`

## tmux version is too old

You can install latest *tmux* from source, check https://github.com/tmux/tmux

## How to skip the check

If can't skip this check by adding the following in your .tmux.conf file:

```
set -g @fingers-skip-health-check '1'
```

## Wrong $TERM value

Tmux fingers works better with proper 256 support. Set `@default-terminal` to either `screen-256color` or `xterm-256color`.

```
set -g @default-terminal "screen-256color"
```

## submodules not initialized properly

This could happen after an update from a tmux-fingers version prior to 0.6.x,
ensure that all tmux-fingers dependencies are installed properly by running the
following:

```
cd ~/.tmux/plugins/tmux-fingers
git submodule update --init --recursive"
tmux source ~/.tmux.conf"
```

## reattach-to-user-namespace is recommended

If you are using tmux 2.5 or less and OSX, it's recommended that you install `reattach-to-user-namespace` in for system clipboard integration.

```
brew install reattach-to-user-namespace
```

Remember that you need to install [tmux-yank](https://github.com/tmux-plugins/tmux-yank) as well.