Skip to content

fraxflax/nw-watchdog

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 

Repository files navigation

nw-watchdog

nw-watchdog is a higly configurable network watchdog written in POSIX shell script for use in Linux, depending only on Linux most standard tools that are normally installed by default in all distributions (also see the DEPENDENCIES section).

It monitors the network connectivity to a specified TARGET and/or the next hop towards that TARGET, alerting upon lost connectivity explaining what is wrong. It can reset the source interface and will detect topology changes and, if allowed, reconfigure itself accordingly. It's intended to run as a daemon and has an option to install itself as a systemd service. If you want to monitor the connectivity to several TARGETs, you can run several instances of nw-watchdog using different --pidfile option arguments.

nw-watchdog is free software written by Fredrik Ax <nw-watchdog@axnet.nu>.
Feel free to modify and/or (re)distribute it in any way you like.
... it's always nice to be mentioned though ;-)

nw-watchdog comes with ABSOLUTELY NO WARRANTY.

If you expirence any problems with nw-watchdog, are lacking any functionality or just want to voice your opions about it, feel free to contact me via e-mail.

INSTALL

Just copy / download the nw-watchdog script into your PATH and make it executable.

  • Latest release of the script is version 1.1.5.

    Download v1.1.5: nw-watchdog

    curl -o /usr/local/bin/nw-watchdog https://raw.githubusercontent.com/fraxflax/nw-watchdog/v1.1.5/nw-watchdog ; chmod a+rx /usr/local/bin/nw-watchdog
    
  • All releases are available for download here: https://github.com/fraxflax/nw-watchdog/releases

  • The latest TESTING version (unreleased main branch) of the script may contain new features / changes that will be in the next release. If so, they are documented in documentation/changelog.md.

    Download TESTING: nw-watchdog

    curl -o /usr/local/bin/nw-watchdog https://raw.githubusercontent.com/fraxflax/nw-watchdog/main/nw-watchdog ; chmod a+rx /usr/local/bin/nw-watchdog
    

DOCUMENTATION

See documentation/help.md for extensive documentation including examples.
The same documentation is also available by running:
nw-watchdog --help