Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve system update documentation #1414

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

DemiMarie
Copy link
Contributor

This is a very important task, but it is often not done due to bad tools.

Marking as draft because support for System76 firmware update has not been merged yet.

Copy link
Contributor

@deeplow deeplow left a comment

Choose a reason for hiding this comment

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

Thanks so much for documenting this feature. It would be a shame if something new in 4.2 didn't get much use because users didn't know it existed (other than by reading release notes).

I have added a few suggestions.

Copy link
Contributor

Choose a reason for hiding this comment

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

The contents of this file may be better suited at https://www.qubes-os.org/doc/how-to-update/. IMO a user would expect all update-related information to be on that page.

Comment on lines 15 to 17
- If a device is attached to dom0, you can also use **fwupd**. Qubes OS ships
a modified version of fwupd that does not require Internet access to use.
Instead, firmware is fetched via qrexec.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
- If a device is attached to dom0, you can also use **fwupd**. Qubes OS ships
a modified version of fwupd that does not require Internet access to use.
Instead, firmware is fetched via qrexec.
- If a device is attached to dom0, you can update using the `qubes-fwupdmgr`.
This is a modified version of fwupd which fetches updates via the default
admin qube update proxy (`sys-firewall` by default).

Re-phasing suggestion on the networkless aspect.

I would also suggest adding practical steps on how this tool can be used.

This is a very important task, but it is often not done due to bad
tools.  Also correct some outdated information on the "how to update
software" page.
@DemiMarie DemiMarie changed the title Draft: Document how to update system firmware Improve system update documentation Aug 26, 2024
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