Created: 2012-03-20 23:17
Updated: 2019-03-08 01:53
License: gpl-3.0


tunnelmon -- Monitor and manage autoSSH tunnels


tunnelmon [-h]

tunnelmon [-c] [-n] [-u] [-l LEVEL] [-g FILE]


tunnelmon is an autossh tunnel monitor. It gives a user interface to monitor existing SSH tunnel that are managed with autossh.

It can print the current state of your tunnels or display them in an interactive text-based interface.

tunnelmon is released under the GNU Public License v3.


tunnelmon targets Linux operating systems, and depends on:

  • openssh-client
  • python3

You may want to install the recommend pacages also:

  • autossh


Called without option,tunnelmon will print the current state of the autossh tunnels and exit.

  • -h, --help: Show a help message and exit

  • -c, --curses: Start the interactive user interface. Tunnels states will be updated regularly and you will be able to control them (see below).

  • -n, --connections: Display only SSH connections related to a tunnel.

  • -u, --tunnels: Only display the list of tunnels processes.

  • -l LEVEL, --log-level LEVEL: Control the verbosity of the logging, the greater, the more verbose. Available log levels are: error < warning < debug. Defaults to error, which only prints unrecoverable problems.

  • -g FILE, --log-file FILE: Log messages are written to the given FILE. Useful to debug the interactive interface. If not set, asking for the curses interface automatically set logging to the "tunnelmon.log" file.


Keyboard commands:

  • and : Select a tunnel.
  • R: Reload the selected autossh instance (i.e. send a SIGUSR1, which is interpreted as a reload command by autossh).
  • C: Close the selected tunnel (i.e. send a SIGTERM).
  • N: Show the network connections related to each tunnel instances.
  • Q: Quit tunnelmon.
Cookies help us deliver our services. By using our services, you agree to our use of cookies Learn more