GUIDES › ConfigWatch
Other languages English · 日本語 · 한국어 · 简体中文
ConfigWatch
Read-only SSH configuration backup with line-level diffs — 0.4.5
In this version
- A saved licence is verified every time it is read — only the key's signature, product and signed expiry decide the plan.
- Deleting the data folder no longer restarts the 30-day trial: the trial start is also recorded outside the data folder, and the earliest record wins. The check stays on this computer.
- The licence panel no longer contradicts itself: during a trial it shows the trial and its days left, and a saved key that has expired or is not valid is marked as not in use, with a Remove button.
- The Windows installer is Authenticode-signed and timestamped.
1. Install
Pick the build for the machine you are installing on. Every file below is the current release; older versions are listed on the release notes page.
- macOS · Apple silicon ConfigWatch-0.4.5-arm64.dmg
- Windows installer ConfigWatch-0.4.5-x64.exe
- Linux · AppImage ConfigWatch-0.4.5-x86_64.AppImage
- Linux · Debian/Ubuntu ConfigWatch-0.4.5-amd64.deb
Verify what you downloaded. The published checksums are at ConfigWatch-SHA256SUMS.txt
On macOS or Linux:
shasum -a 256 ConfigWatch-0.4.5-arm64.dmg
On Windows:
Get-FileHash -Algorithm SHA256 ConfigWatch-0.4.5-x64.exe
The macOS build is notarised by Apple, so it opens without a warning. The Windows installer is Authenticode-signed and timestamped. The certificate is new, so SmartScreen may still show a warning until it has built reputation — if it does, choose More info → Run anyway.
2. First run
- Create a read-only SSH account on the device. ConfigWatch never needs more than that, and never escalates — not even on Yamaha, where it stays a general user rather than going to
administrator. - Add the device and choose the vendor, or let it detect: Cisco IOS/IOS-XE, MikroTik RouterOS, Ubiquiti EdgeOS/UniFi, and Yamaha RTX/NVR/FWX.
- Back it up. Secrets are masked before anything touches disk, and a configuration that could not be fully masked is refused rather than stored.
Every install starts with a 30-day trial of the paid edition. Nothing is asked for up front — no card, no account, no email address.
3. Administration
Yamaha RTX is not verified on real hardware
The profile was built from Yamaha’s own documentation and the vendor list says it is unverified. Paging is stepped through with spaces rather than by sending console lines infinity — that command shows up in show config even unsaved, so sending it would put our line into your backup. If you run RTX hardware and it works, we would like to hear.
Rollback
ConfigWatch never pushes configuration to a device. It generates rollback commands for you to read and run yourself. If you saved rollback commands from a version before 0.4.1, regenerate them — a bug affecting every vendor made those commands re-apply a change before removing it.
Free and Pro
Free browses history for 3 devices. Every device you register is backed up, on every tier — the limit is on browsing history, not on collection. Devices beyond the limit are deliberately still listed so you can remove them.
SSH host keys
Since 0.4.4 ConfigWatch pins each device’s SSH host key. The first connection records the key the device presents; every later connection must present the same key, and one that presents a different key is refused before the login is sent — the collection fails rather than hand the read-only credentials to whatever answered at that address. The recorded keys are kept in known-hosts.json in the data folder:
- macOS —
~/Library/Application Support/ConfigWatch/known-hosts.json - Windows —
%APPDATA%\ConfigWatch\known-hosts.json - Linux —
~/.config/ConfigWatch/known-hosts.json
It is one JSON object with an entry per device, keyed by the host and port as you entered them, with the SHA-256 hash of the device’s key as the value — for example {"192.168.1.10:22":"3f9a…"}. When you legitimately replace a device or regenerate its host key, remove that device’s entry, or delete the whole file to re-learn every device. The next collection records the new key. The file is read afresh at the start of every backup run, so ConfigWatch does not need restarting; edit it while no backup is running.
Language
Settings → Language. English and Japanese. Device configuration text is never translated.
Where your data lives
Everything ConfigWatch stores stays on the computer it runs on. None of it is sent to us, to an analytics company or to an advertising network.
Licence keys
The key arrives by email after purchase. It is checked on this computer, so ConfigWatch never contacts a licensing server. When the 30-day trial ends, or a subscription lapses, ConfigWatch drops to the Free limits above: scheduled backups, rollback commands and audit export stop, and history already stored is kept.
4. Firewall
- Outbound — SSH (usually port 22) to the devices you back up. No inbound rule is needed.
5. Connect to MeshWatch Central
Optional. Central gathers alerts from several products into one inbox and correlates them by device. Only alert summaries are sent to Central. Configuration text never leaves this computer.
- In Central, open Agents, choose ConfigWatch, type any label you like — it is just a name to tell installations apart — and press Issue token. The token is shown once.
- Pick ConfigWatch in that dropdown. A token belongs to the product it was issued for, and Central files every report under that product rather than under the application that sent it. A ConfigWatch installation given another product’s token connects and reports successfully, and its data appears under the other product while the ConfigWatch view stays empty — with no error at either end.
- In ConfigWatch, open the MeshWatch Central settings and enter Central’s address as
http://<central-server>:8443and the token. Use the server’s address, notlocalhost, unless Central runs on this same machine. - Tick the box that sends alerts to Central, save, then press Test connection. It should report success.
Alerts raised from then on appear in Central. Past alerts are not backfilled. The full walkthrough is in the MeshWatch Central guide.
6. Troubleshooting
Nothing is arriving
The firewall is the usual reason — see section 4. After that, check that the device is pointed at this computer’s current local IP address; a DHCP lease can move it.
Test connection to Central fails
bad-token means the token is wrong or was revoked — issue a new one. unreachable means the address is wrong or a firewall is in the way; port 8443 must be open on the Central server. Note it is http://, not https://, unless you put a reverse proxy in front of Central. wrong-product means the token was issued for a different product; the message names which one. Issue a token for ConfigWatch instead and revoke the other. If the address looks right but Central is still unreachable, check it for a typo: most mistyped addresses are still valid addresses — 127.0.0.01 is read as 127.0.0.1 and 192.168.001.5 as 192.168.1.5 — so the connection quietly goes somewhere else. In the current releases these results are shown as sentences — a token Central refuses is explained as possibly revoked or issued by a different Central — and the code itself appears when you hover over the message.
Central shows this agent as “connected”, but nothing arrives
That is not a failure. connected means the test succeeded and nothing has been sent yet; the row switches to reporting on the first real report, because a product sends only when something happens. ConfigWatch switches to reporting after one backup run, even when nothing changed. A row still reading waiting has never reached Central.
A backup fails with “Host denied (verification failed)”
The device presented a different SSH host key from the one recorded on the first connection, so ConfigWatch refused to log in. The status line after the run names the device by host and port, for example 1 failed — 192.168.1.10:22: Host denied (verification failed). If you replaced the device or regenerated its key, remove its entry from known-hosts.json — see SSH host keys. If you did not, find out why the key changed before you do: something else may be answering at that address.
A collection failed instead of saving a short config
That is deliberate. If the device’s paged output stops before its prompt comes back, ConfigWatch discards the capture and reports The configuration did not finish printing (stopped after N of M pages), so nothing was stored rather than storing a truncated copy. A truncated copy would otherwise be saved as that day’s configuration and show up as a large, false change. Run the backup again; if it keeps failing on the same device, write to support with the vendor and model.
Problems that affect every product
A blank window after upgrading, Ubuntu 24.04 refusing to start the app, credentials stored as plain text on Linux without a keyring, alert email not being delivered — these are the same on every product and are collected on the support page.
Still stuck
Write to support@meshwatch.app with the version number and what you expected to happen. First reply within two business days, Monday to Friday.