Skip to main content

Updater

Updater uploads or selects an OS image, then applies it on the device.

Applying an update will reboot the device.

Select An Update Image

You must choose exactly one source at apply time:

Upload

  1. Choose an image file from your computer (.img, .tar.gz, .zip, .bin, .xz).
  2. Click Upload image.
  3. The UI shows the detected filename, size, and SHA256 after upload.

Notes:

  • Upload stores the file on the device (it becomes available as a Media file source too).
  • The stored upload can be removed from the Updater UI.

Media

Select an image file that already exists on the device under OS > Media.

  • The list is filtered to common image extensions (.img, .tar.gz, .zip, .bin, .xz).
  • Refresh reloads the device media list.
  • Remove deletes the selected file from the device media store.

URL

Paste a URL for the device to use as the update image source.

Apply Update

  1. Click Apply update.
  2. Read the warning and check the confirmation box.
  3. Click Continue & apply.

What to expect:

  • Applying an update stops all streams.
  • The device reboots.
  • The Web UI disconnects during the reboot, then reloads when the device comes back.
  • The updater now applies directly from the selected image_url; there is no separate long-lived staging step in the user workflow.

Stages (What They Mean)

The UI maps updater stages to labels:

  • idle: Idle
  • downloading: Downloading update
  • verifying: Verifying update
  • awaiting_window: Pending apply
  • applying: Applying
  • rebooting: Rebooting
  • complete: Complete
  • rolled_back: Canceled / Rolled back

Notes:

  • Cancel is only enabled while an update is active and not currently applying/rebooting.
  • The Current state panel is driven by live updater state and shows progress, timestamps, cache usage, and artifact URL/checksum when available.
  • The page can optionally delete the selected image after apply completes.