Skip to content

docs/guides/capsule-update.md: update for V2#1230

Open
filipleple wants to merge 1 commit intomasterfrom
capupd_update
Open

docs/guides/capsule-update.md: update for V2#1230
filipleple wants to merge 1 commit intomasterfrom
capupd_update

Conversation

@filipleple
Copy link
Member

@filipleple filipleple commented Feb 27, 2026

Addresses Dasharo/dasharo-issues#1440

  • update progress bar image to the new look of the update screen which includes a logo (Capsules / Improve user experience / Flexible logo #1437)
  • demonstrate new results screen for both success and failure cases (Capsules / Improve user experience / Results screen #1434)
  • explain that a failure to flash is followed by a recovery attempt which is not guaranteed to succeed, but should leave the system bootable in most cases (Capsules / Improve user experience / Recovery #1435)
  • remove instructions to disable Intel ME manually (Capsules / Improve user experience / Auto-disabling Intel ME #1438)

ref: DSH-1132

@filipleple filipleple self-assigned this Feb 27, 2026
* update progress bar image to the new look of the update screen which includes
  a logo (Capsules / Improve user experience / Flexible logo #1437)
* demonstrate new results screen for both success and failure cases (Capsules /
  Improve user experience / Results screen #1434)
* explain that a failure to flash is followed by a recovery attempt which is
  not guaranteed to succeed, but should leave the system bootable in most cases
  (Capsules / Improve user experience / Recovery #1435)
* remove instructions to disable Intel ME manually (Capsules / Improve user
  experience / Auto-disabling Intel ME #1438)

Signed-off-by: Filip Lewiński <[email protected]>
Copy link
Member

@SergiiDmytruk SergiiDmytruk left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some things have changed since the task was originally written and I now realize we wouldn't be able to remove old instructions even if V2 code was enabled everywhere at once just because it would apply only to newer releases:

  • the table in Supported devices should additionally indicate from which version V2 is available
  • looks like a couple places need content tabs to be able to cover both older and newer implementations
  • ME doesn't need to be HAP-disabled only if on-disk capsules are used, in which case CapsuleApp.efi should get -OD flag at the end (position matters, argument parsing is quite rigid and there is an optional parameter for this flag)

succeed, but should leave the system bootable in most cases.

After either a successful or failed update, the machine will reboot
automatically. After that, if everything succeeded, you should have an updated
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

With the results screen the reboot is automatic only in case of a success, a failure requires pressing Enter.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This image is not very legible.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants