Manual install process

The manual process described below allows you to selectively update files on your router instead of running install.sh in the latest installer script (v3.4.7). These instructions presume that you have already replaced your stock firmware with DD-WRT, Turris, OpenWrt / LEDE, GNU/Linux, Asuswrt-Merlin, Tomato, etc. and have mounted a USB drive (preferably with ext4 file system) to /opt/.

Sign-up to get automatic notifications when there are updates to YAMon.

Latest versions:

  • Bash scripts (on the router): v3.4.7, and
  • HTML files (for the reports): v3.4 (internal to `yamon3.4.html`: v3.4.1).

To see which files you currently have installed on your router, check the reports:

Past Versions

If you want to revert to a previous version, select it here:

The following files have been tweaked/updated in the past 7 days - either run install.sh on your router or click to download the files individually:

Manual Steps:

Before going any further ...
Remember that I said *properly* configured firmware? A number of firmware settings are known to prevent YAMon from collecting accurate traffic data - the most common recent culprit has been the Shortcut Forwarding Engine (SFE) option which was added in DD-WRT build 33006+ (and is enabled by default). Other known offenders include `enhanced privacy` tools (like PrivOxy) and Universal Plug and Play (UPnP) settings - see PrivOxy & UPnP. Apparently `Cut Through Forwarding` is similar to SFE so it too will be problematic but I don't have a lot of details on that yet... stay tuned!. These options *must* be disabled if you want to get accurate results from YAMon!

If you are updating from a previous version of YAMon (rather than a fresh install), back up everything before proceeding! This includes any customizations you've made to devices in the reports - see Exporting device customizations.

  1. Download and expand the yamon3.4.7.zip archive onto your computer's harddrive
  2. On your router, create a directory named YAMon3 in /opt/
  3. Using WinSCP or equivalent, copy the following files to /opt/YAMon3/: setup3.4.7.sh, yamon3.4.7.sh, readme.txt, default_config.file, startup.sh, shutdown.sh, restart.sh, h2m.sh, glc.sh, wd.sh, purge.sh, organize.sh
    all of these files are included in the zip file but you can also click to download them individually
  4. Create a directory named includes in /opt/YAMon3/
  5. Copy the following files to /opt/YAMon3/includes/: util3.4.7.sh, versions.sh, defaults.sh, getLocalCopies.sh, hourly2monthly.sh
  6. Create a directory named strings in /opt/YAMon3/ and then a directory named en in /opt/YAMon3/strings/
  7. Copy getlatest.sh to /opt/YAMon3/strings/en/
  8. Create a directory named www in /opt/YAMon3/
  9. Copy strings.sh to /opt/YAMon3/www/
  10. Create a directory named css in /opt/YAMon3/www/
  11. Copy yamon3.4.html to /opt/YAMon3/www/css/
  12. Create a directory named js and a directory named images in /opt/YAMon3/www/
  13. Give setup3.4.7.sh execute permissions - e.g. chmod 700 /opt/YAMon3/setup3.4.7.sh or better yet, use WinSCP
  14. Run setup3.4.7.sh - e.g., /opt/YAMon3/setup3.4.7.sh
  15. Answer the prompts in the Setup script and finally launch YAMon!

To view your reports,

  • go to http://192.168.1.1/user/index.html

    This may change slightly depending on your router IP address and/or your firmware... in particular, users upgrading from yamon3.1.x might still use http://192.168.1.1/user/yamon3.4.html until you update the value of `_setupWebIndex` in `config.file`.

    It will take several minutes for your data to appear in the reports (that is dictated by your selections during the setup script).

Sign-up to get automatic notifications when there are updates to YAMon.

If you are having problems, please see the Common Problems page or send a question to questions@usage-monitoring.com.