Wheelhouse docs

Power#

The Power panel is the third panel on the Overview tab of the System page. It restarts the router or shuts it down. Both act at once: neither is a pending change.

Its first line: "Changes that are not saved are lost when the router restarts."

How it works#

Two buttons, Restart router and Shut down. Only an administrator can use them; for every other role they are disabled, with the tooltip "Admin role required".

Pressing either does not act. The panel asks for the host name instead:

Enter the host name, edge-1, to restart the router

("to shut down the router" for Shut down). Restart now or Shut down now stays disabled until the text typed matches the router's host name exactly. Cancel returns to the two buttons.

When the router accepts, the panel says "The router is restarting. This page reconnects when it is back." or "The router is shutting down." When it refuses, the panel shows the router's reason.

Both are recorded in the audit log, whether they worked or not, with who asked, their role and their address: "Restarted the router" and "Shut down the router".

Before you press it#

  • Shut down means someone has to switch the router on again. Nothing in the product can start a router that is off. On a router in another building, Shut down ends remote access.
  • A restart ends an auto-revert window. If changes applied with auto-revert are still waiting to be kept, the router starts with its saved configuration, without them.

The restart that completes an upgrade#

A new system image is used from the next restart, and this panel is where that happens. The order: add the image, check that the new one shows as Default and the old one still as Running, save the configuration, then restart from here.

What this panel does not do#

  • No scheduled restart. It restarts or shuts down at once.
  • No power on. Nothing in the product can start a router that is off.
  • No factory reset. That is its own panel below: Factory reset.
  • No agent restart. Restarting the agent alone, without restarting the router, is Restart agent on Agent settings (Admin → Agent settings).

For automation#

bash
curl -sk -X POST -H "Authorization: Bearer $T" \
  -H 'Content-Type: application/json' -d '{"action":"reboot"}' \
  https://<router>:8443/api/system/power

POST /api/system/power needs the admin role. action is reboot or poweroff; anything else is refused with 400: "action must be reboot or poweroff". The audit entry is power-reboot or power-poweroff, written whether the call succeeded or failed, with the router's own error when it failed.

See also#

Updated 2026-09-18 manual system power restart