Wheelhouse docs

Operations#

The work that is not configuration: getting a copy of the router off the box, putting it back, moving to a new release, getting in again when you cannot, and the small settings that make a router easier to live with.

Two of these are worth doing before anything else on a new router.

  1. Take a backup that is actually complete. The configuration file on its own is not a backup — a restore from it produces a router nobody can log in to.
  2. Turn SSH on, and restrict it, or decide deliberately to leave it off. Several procedures here need a shell, and a freshly installed router has no SSH at all.

Keeping a copy#

GuideThe job
Take a backup that is actually completeWhat a backup has to contain, and the one command that gets all of it
Restore a configurationPutting a config.boot back on a running router
Rebuild a dead router onto a new boxNew hardware, old identity, in roughly twenty minutes
Undo the last commitRevisions, diffs and rollback

Moving to a new release#

GuideThe job
Upgrade the whole systemA second image installed alongside the running one
Upgrade the agent onlyA new control plane without a reboot
Learn that a release existsNothing on the router checks; here is what does

Getting in, and staying in#

GuideThe job
Locked out of the UIEvery way back in, in the order to try them
Turn SSH on, and restrict itIt is off by default; here is how to turn it on without regretting it
Working from the consoleThe banner, the accounts, and what the console can do that the UI cannot

Housekeeping#

GuideThe job
Run something on a schedulesystem task-scheduler, and where to keep the script
Kernel tunablessystem sysctl parameter, and the two or three worth touching
Time synchronisationServers, allowed clients, and checking the router agrees with the world

Checked against docs/backup-restore.md · docs/upgrade.md · docs/security.md · ui/src/pages/SystemSettings.tsx

Updated 2026-09-02 operations backup upgrade