Panel Power and Hardware
Use Power and hardware
(/rust/power-hardware) to review power profiles, live
CPU/GPU readings, heat and benchmark evidence before deciding between
lower sustained watts and higher performance. Power
options (/rust/power-hardware/options),
GPU telemetry and caps
(/rust/power-hardware/gpus) and GPU tuning and
benchmarks (/rust/power-hardware/tuning) replace
the three classic tabs with native forms. The earlier GPU &
Power page remains a separate diagnostic view during the
transition. The System hardware page
(/rust/system/hardware) contains read-only inventory.
The Power and hardware page displays Current evidence (CPU/temperature sample, GPU limit and device status, power profiles and drift, tuning and completed runs), Guided task forms for administrators, Controls, effects and registered routes, and More hardware controls. Sensor values come from recorded samples: missing values are not zero and detected devices are not automatically supported for execution. A cap is a sustained power limit, not protection against a momentary current spike.
Native pages and safe workflow
The main page links to three native pages; use its guided tasks when changing host performance or verifying a cap with a before-and-after benchmark. Administrators see server-rendered forms that post to the same privilege-owning services as the former classic tabs. Viewers see evidence, explanations and navigation, but not the privileged forms. Every form label has a help marker. A successful form reply includes the full owner response rather than guessing that hardware was updated.
- Open Power options. Expand Power state and equipment, Budget and UPS evidence, Boot and stability evidence, and Native watchdog state to inspect live device support. For manual edits, type a new value next to a current setting and press Apply selected live values; leave all unchanged rows blank. Use Save selected values to create a custom profile from selected entries. Capture all live settings saves a named snapshot. Each profile exposes Apply now, Use at boot, and, for custom profiles, Delete custom profile. A boot profile can be cleared with Stop applying profile at boot. Reapply only drifted settings affects drifted values and Save automatic reapply policy changes drift behavior. High-impact boot persistence has its own force checkbox.
- In Power options, set the PSU, UPS and platform estimates under Save power and UPS budget. If configured, enter peer/UPS endpoint entries. Use Annotate boot to distinguish manually interrupted boots from suspected crashes. Request watchdog policy lets an administrator request arm or disarm; success must be confirmed by the hardware owner. Recheck power owner only refreshes readiness.
- For machine restart or poweroff, choose Review restart or Review shutdown. The preview names running work and returns a short-lived, signed review. No restart or shutdown occurs at this stage. Inspect it, type the exact issued phrase, acknowledge interruption, tick confirmation and select Confirm reviewed host action. If the review expired or the action changed, request a fresh review. Do not confuse this with an inference-instance restart.
- Open GPU telemetry and caps. Expand GPU inventory, GPU runtime, memory, process residency and thermals and Device-bound power limits and saved policy. A supported writable device shows Set GPU cap now with its device-specific watt range. Forget saved cap only removes automatic reapplication intent without restoring the live cap. Use Restore exact previous cap on the Overview guide when actual hardware restoration is required.
- Open GPU tuning and benchmarks. Expand the GPU settings and benchmark evidence before editing clocks, memory, voltage or fan. Enter selected values and use Apply selected tuning values; use Save selected GPU settings as profile, Capture current GPU profile, or Restore recorded boot defaults for profile operations. For a trial run use Apply and benchmark with rollback, which asks for a running instance and consistent benchmark parameters. Profiles expose Apply tuning profile, Use GPU profile at boot, Apply profile and test with rollback, Delete GPU profile and Stop using GPU profile at boot. Changing clocks or fans can increase heat, power and reset risk.
- For a baseline, use Start GPU benchmark with an actual running instance, prompt tokens, generated tokens, repetitions, mode and label. Check the observed result before comparing. Stop current GPU benchmark and Delete finished benchmark record affect the active run and saved record respectively. Live benchmark status updates without a full page reload while the page is visible; a failed poll says unavailable rather than reporting false success.
- Back up GPU firmware (read only) and Inspect local ROM without flashing do not flash the card. A saved firmware image can be retrieved from Download ... (read-only). A ROM check may advise against flashing; do not treat inspection as authorization to install it.
All the owner routes shown on the native pages remain subject to authentication, authorization and their own device-specific checks. Any failed readback or unrecognized device must be investigated before the next action. No GPU or UPS sensor data is synthesized for display.
Guided task: cap a GPU and measure the speed cost
- In GPU telemetry and caps, identify a supported writable GPU, its exact PCI address and reported min/max watts. Record live cap, saved cap and In effect. A missing bound readback blocks a verified cap change.
- On a running, idle GPU instance, open GPU tuning and benchmarks and start a quick benchmark with Start GPU benchmark. Keep the instance, prompt depth, predicted tokens and repetitions fixed. Wait for a finished run; note Decode t/s, Mean W and Peak junction. Do not infer a baseline from a still-running job.
- Stop the inference instance on Instances
(
/rust/instances). GPU cap writes refuse active inference. Under Guided task: cap a GPU and measure the speed cost, enter PCI address and Whole watts within the card's range, tick the confirmation and choose Set verified GPU cap. Only a device-bound matching live cap is reported as verified. - Restart the same instance and run an identical benchmark. Once both runs are finished, in Power and hardware enter Baseline run ID and Capped run ID under Compare completed benchmark runs, then select Compare measured runs. The comparison requires matching GPU devices, instance, model name, depth, token count and repetitions, and clean reset-checked quick runs. It reports speed_cost_pct (positive means slower), mean watts and peak junction changes only when those sensors recorded measurements. Different hardware or workload settings are rejected; a cap is not automatically the sole cause of the change. Stop the instance again after measuring.
- Enter the same PCI address, confirm and select Restore exact previous cap. This restores the saved exact microW value only if the same physical device and expected live cap are still present; otherwise inspect the mismatch and do not force a write. To leave the cap configured, skip restore intentionally and retain the cap policy.
The comparator is read-only, reports missing sensor data as unavailable and does not modify a power cap. Records absent from the recent benchmark history must be located in GPU tuning and benchmarks rather than guessed.
The guide power.cap-and-compare records the input fields
pci, watts and instance. Its set
step has a registered restore undo action. For a plain policy removal
without live restoration, the separate Clear saved GPU power cap
(leave live cap unchanged) control does not roll back
the hardware cap.
Guided task: switch to stable maximum performance
- Read Power profiles and drift and the built-in Stable performance profile. It requests supported performance-governor and platform low-idle-transition options; it is not a promise of maximum GPU clocks or measured improvement.
- Under Guided task: switch to stable maximum performance, tick the confirmation after reviewing extra heat, sustained and idle draw, fan noise and rollback, then select Apply stable performance.
- The page captures affected current values before applying. The helper verifies each selected setting. If an apply partly fails, the saved undo record remains for recovery; do not assume the machine is in a uniform state.
- Observe CPU/thermal samples and compare an unchanged workload. Select Undo performance change to restore the recorded prior values. Undo requires successful per-setting readback. Only one pending performance undo is allowed, and this action does not persist a boot profile.
- To keep settings through reboot, use Use at boot in Power options; high-impact PCIe, storage, GPU, turbo and watchdog settings require explicit review and force consent. Remove boot power profile reverses persistence, not necessarily live settings.
Telemetry, logging and tuning
Live CPU, GPU, power and temperature are shown from
/api/hwinfo/live, /api/gpus,
/api/gpu, /api/gpu-tune and other read-only
routes. Sampler sequence, missing sensor reason and benchmark history
matter when comparing runs. The Thermal logs capability
draws from the power-budget and benchmark history reports; these are
historical readings, not a substitute for a current device sensor.
Review Power budget and UPS to compare estimates
against supply and UPS ratings, and Boot stability and
annotations to distinguish manually interrupted boots from
crash evidence.
For GPU tuning, Apply tuning settings, Save GPU tuning profile and Set GPU profile at boot may change clocks, voltages, power and fan behavior. Repeated workload benchmarks are necessary; higher clocks can also increase watts, temperatures, throttling, reset risk and instability. GPU tuning and firmware backup/check remain separate from verified GPU power cap operations. GPU firmware inspection does not flash firmware.
Control reference
The help markers beside each native control use these exact explanations. No command-line flags are assigned to these controls in the UX registry; the API routes below are the executable interface.
| Control | Tooltip | Registered API routes |
|---|---|---|
Power and hardware (power.overview) |
Review power, heat, speed and device support before changing host settings. | GET /api/power |
Live CPU and thermal telemetry (power.live-cpu) |
View sampled CPU and temperature readings; unavailable or stale sensors are not measurements. | GET /api/hwinfo/live,
GET /api/telemetry |
Live GPU telemetry (power.live-gpu) |
Inspect GPU power, temperature, memory and activity; sensor presence does not prove workload speed. | GET /api/gpus, GET /api/gpu,
GET /api/gpu-tune |
Thermal logs (power.thermal-logs) |
Review recorded heat and power history; missing log samples must not be treated as zero heat. | GET /api/power/budget,
GET /api/gpu-tune/bench |
GPU cap status (power.cap-status) |
Compare live, saved and device-bound GPU caps; a saved cap alone does not prove it is applied. | GET /api/gpu-power |
Set GPU power cap (power.cap-set) |
Limit sustained AMD GPU watts; heat may fall but benchmark speed may also fall, and short spikes remain. | POST /api/ux/power/cap,
POST /api/gpu-power/set |
Restore exact previous cap (power.cap-restore) |
Restore the recorded microW cap only on the same device at the expected live value; this may raise heat. | POST /api/ux/power/cap-restore,
POST /api/gpu-power/clear |
Clear saved cap only (power.cap-clear) |
Forget automatic cap reapplication without restoring the current live limit; a reboot can change it. | POST /api/gpu-power/clear |
Power profiles and drift (power.profiles) |
Review current settings, saved boot profiles and drift before applying changes to CPU, GPU or storage. | GET /api/power |
Apply stable performance (power.performance) |
Apply the available stable-performance settings now; idle draw and heat may rise, and previous values are saved for undo. | POST /api/ux/power/performance,
POST /api/power/apply |
Undo stable performance (power.performance-undo) |
Reapply the captured pre-change settings; any failed setting is reported rather than called restored. | POST /api/ux/power/performance-undo |
Use profile at boot (power.boot-profile) |
Persist a selected profile for future boots; high-impact settings require a separate force review. | POST /api/power/persist,
POST /api/power/unpersist |
Capture or save profile (power.profile-save) |
Capture live settings or save selected settings so changes can be inspected and reused. | POST /api/power/profile/capture,
POST /api/power/profile/save |
Delete profile (power.profile-remove) |
Delete a custom profile, not a built-in preset; confirm any boot policy separately. | POST /api/power/profile/delete |
Automatic drift reapply (power.auto-reapply) |
Ask the panel to reapply a boot profile after drift; repeated changes can increase power use. | POST /api/power/settings |
Power budget and UPS (power.budget) |
Estimate sustained and peak loads against power supplies and UPS ratings; estimates are not measured spikes. | GET /api/power/budget,
POST /api/power/settings |
Boot stability and annotations (power.stability) |
Review journal evidence and mark manual stops before interpreting crashes or unclean boots. | GET /api/power/stability,
POST /api/power/annotate |
Hardware watchdog (power.watchdog) |
Review watchdog status; an enabled policy is not evidence that a physical watchdog is armed. | GET /api/power/watchdog,
POST /api/power/watchdog |
Recheck hardware helper (power.helper) |
Refresh helper availability before altering privileged power settings; no device changes are made. | POST /api/power/recheck |
GPU clocks, voltage and fan tuning
(power.gpu-tuning) |
Inspect or apply device-bound tuning; a faster clock can raise watts and temperature or destabilize work. | GET /api/gpu-tune,
POST /api/gpu-tune/apply |
GPU tuning profiles (power.tune-profiles) |
Save, apply, delete or select a boot GPU profile; test stability before using it at startup. | POST /api/gpu-tune/profile/save,
POST /api/gpu-tune/profile/apply,
POST /api/gpu-tune/profile/boot,
POST /api/gpu-tune/profile/unboot,
POST /api/gpu-tune/profile/delete |
Compare measured GPU benchmark runs
(power.compare) |
Compare two finished, verified runs with matching workloads to quantify throughput, watts and heat without guessing. | GET /api/gpu-tune/bench |
Measure GPU speed cost (power.benchmark) |
Run repeatable decode benchmarks before and after a cap; compare throughput alongside mean watts and peak heat. | GET /api/gpu-tune/bench,
POST /api/gpu-tune/bench/start,
POST /api/gpu-tune/bench/stop,
POST /api/gpu-tune/bench/delete |
GPU firmware inspection (power.vbios) |
Back up GPU firmware or check a local ROM file; inspection is not permission to flash firmware. | POST /api/gpu-tune/vbios/backup,
POST /api/gpu-tune/rom-check |
Review host restart or shutdown
(power.host-review) |
Show running work and a time-limited review token before a host restart or poweroff; preview does not shut anything down. | POST /api/host-power/preview |
Confirm reviewed host action (power.host-execute) |
Execute only after a fresh signed impact review, exact typed phrase, and acknowledgement that running work may stop. | POST /api/host-power/action |
Edit live power settings (power.settings-edit) |
Apply selected per-device values now through the privileged owner; boot persistence is unchanged and each result needs verification. | POST /api/power/apply |
Apply saved power profile (power.profile-apply) |
Apply a saved profile to the running machine without automatically setting it as the boot profile. | POST /api/power/apply |
Reapply drifted power values (power.drift-reapply) |
Reapply only the boot-profile settings that differ from reported live values; inspect partial failures. | POST /api/power/apply |
Restore GPU boot defaults (power.tune-restore) |
Return selected GPU tuning settings to recorded boot defaults when present; exact device verification still applies. | POST /api/gpu-tune/apply |
Download saved GPU firmware (power.vbios-download) |
Download a previously backed-up GPU firmware image without writing firmware to the device. | GET /api/gpu-tune/vbios/file |
| Capture power profile (power.profile-capture) |
Capture the current readable power settings under a new name; capturing
does not apply or enable a boot policy. |
POST /api/power/profile/capture | | Disable power boot
profile (power.boot-unpersist) | Stop persisting the
selected boot profile without claiming to undo settings already applied
to the machine. | POST /api/power/unpersist | | Save
selected GPU tuning profile (power.tune-profile-save) |
Save the selected GPU clock, fan, voltage or cap values as a profile
without changing live hardware. |
POST /api/gpu-tune/profile/save | | Capture GPU tuning
profile (power.tune-profile-capture) | Capture readable
current GPU settings as a profile; unreadable settings are omitted
rather than assumed. | POST /api/gpu-tune/profile/save | |
Apply GPU tuning profile (power.tune-profile-apply) | Apply
a saved GPU tuning profile live; inspect each device readback and
monitor heat before persisting. |
POST /api/gpu-tune/profile/apply | | Persist GPU tuning
profile (power.tune-profile-boot) | Select a verified GPU
tuning profile for startup; boot-time changes can affect stability and
heat. | POST /api/gpu-tune/profile/boot | | Disable GPU
tuning boot profile (power.tune-profile-unboot) | Stop
applying a GPU tuning profile at boot; this does not undo live changes
already made. | POST /api/gpu-tune/profile/unboot | |
Delete GPU tuning profile (power.tune-profile-delete) |
Delete a custom GPU tuning profile after reviewing whether it remains
selected at boot. | POST /api/gpu-tune/profile/delete | |
Start GPU benchmark (power.bench-start) | Measure the same
running workload repeatedly for a trustworthy GPU speed and power
comparison. | POST /api/gpu-tune/bench/start | | Try GPU
setting and benchmark (power.bench-trial) | Temporarily
apply selected GPU settings while measuring performance; verify rollback
and handle a failed restoration. |
POST /api/gpu-tune/bench/start | | Test saved GPU profile
(power.profile-test) | Benchmark the selected GPU profile
as a temporary trial; compare with baseline and inspect restoration
evidence. | POST /api/gpu-tune/bench/start | | Stop GPU
benchmark (power.bench-stop) | Request cancellation of a
running GPU benchmark and verify that it has stopped before further
tuning. | POST /api/gpu-tune/bench/stop | | Delete
benchmark history entry (power.bench-delete) | Delete one
finished GPU benchmark record; running workloads are not stopped by
deleting history. | POST /api/gpu-tune/bench/delete | |
Back up GPU firmware (power.vbios-backup) | Request a
read-only firmware backup from the selected GPU; never use this action
to flash hardware. | POST /api/gpu-tune/vbios/backup | |
Check local GPU ROM (power.rom-check) | Compare a local ROM
image with the selected GPU without writing the image to the device. |
POST /api/gpu-tune/rom-check |
Related guides
Hardware explains device detection and qualification. Panel Benchmarks and Evals describes performance measurement, and Reference Guided Tasks lists workflow conventions.