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: the web interface's accounts, API tokens and audit log are kept by the agent, not in the router's configuration.
  2. Turn SSH on, and restrict it, or decide deliberately to leave it off. Some tasks still need a shell — putting a script on the router for a scheduled task, for one — and a freshly installed router has no SSH at all.

Keeping a copy#

GuideThe job
Take a backup that is actually completeThe Backup page's encrypted file: taking one, checking it and keeping it off the router
Restore a backupPutting a backup file or a snapshot back on a running router
Rebuild a dead router onto a new boxNew hardware, old identity, in roughly twenty minutes
Undo a changeThe configuration history, what each change did, and restoring the configuration from before it

Moving to a new release#

GuideThe job
Upgrade the whole systemA second system image installed beside the running one
Upgrade the agent onlyA newer agent and web interface, without restarting the router
Learn that a release existsThe router's own Updates panel, and polling the same channel from somewhere else

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; turning it on from System → Settings without cutting yourself off
Working from the consoleThe banner, the accounts, and what the console can do that the web interface cannot

Housekeeping#

GuideThe job
Run something on a scheduleThe Scheduled tasks panel, and where to keep the script it runs
Kernel tunablesThe Kernel parameters panel, and the two parameters the router sets itself
Time synchronisationTime servers, who may ask the router for the time, and checking the clock is right

Updated 2026-09-18 operations backup upgrade