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

Overhaul the hardware guide #224

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

Overhaul the hardware guide #224

wants to merge 1 commit into from

Conversation

nathandyer
Copy link
Contributor

This PR overhauls the hardware guide by making a few key changes:

  1. It removes our specific laptop recommendations, instead referring people to the Qubes hardware compatibility list.
  2. It clarifies a few specific requirements for hardware, namely 32GB of RAM (removing the confusing language about production use), as well as a USB 3.0 flash drive with minimum 8GB of capacity.
  3. It provides a generalized BIOS update section, which points folks to fwupd on supported systems, and to their manufacturers instructions for instances where fwupd is not supported.

Fixes

Fixes #211
Fixes #210
Fixes #69

Testing

  • Visual inspection
  • CI passes

This commit overhauls the hardware guide by making a few key
changes:

1. It removes our specific laptop recommendations, instead
referring people to the Qubes hardware compatibility list.
2. It clarifies a few specific requirements for hardware, namely
32GB of RAM (removing the confusing language about production use),
as well as a USB 3.0 flash drive with minimum 8GB of capacity.
3. It provides a generalized BIOS update section, which points
folks to fwupd on supported systems, and to their manufacturers
instructions for instances where fwupd is not supported.
Copy link
Member

@legoktm legoktm left a comment

Choose a reason for hiding this comment

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

Few notes:

@zenmonkeykstop
Copy link
Contributor

Seconded on the HCL - ISTR it was discussed and we were kindof leaning towards:

  • 1x Qubes-certified recco (most likely the Novacustom NV41 (coreboot/heads still undecided)
  • 1x "mainstream" recco (most likely a Lenovo T-series known to work well with 4.2)
  • only as a 3rd option would we mention the HCL, with limited support implications.

@nathandyer
Copy link
Contributor Author

Thanks both for the review and discussion! I'll table this for now and we can return to it again when the timing is right.

@nathandyer nathandyer marked this pull request as draft July 9, 2024 14:44
@deeplow
Copy link
Contributor

deeplow commented Jul 10, 2024

I just learned via @deeplow that Qubes how has fwupd integration -
freedomofpress/securedrop-workstation#1125; is that stable enough for us to recommend via docs until we build it into the updater? Otherwise I think the steps you added are fine.

If we're recommending fwupd anyways, we might as well use the integrated one, especially in the installation phase, where it's an admin fully dedicated to the thing and not a regular user just wanting to get work done. I don't think it matters much if we do the firmware update prior to the Qubes install or after.

1x Qubes-certified recco (most likely the Novacustom NV41 (coreboot/heads still undecided)
1x "mainstream" recco (most likely a Lenovo T-series known to work well with 4.2)
only as a 3rd option would we mention the HCL, with limited support implications.

I think these are reasonable recommendations. However, for the novacustom one we may want to to provide some guidance. For example, some may see a 32gb dimm and choose it, where the proper choice would be 2*16GB, and then the firmware part may have too many options. In my opinion guidance here will be critical to avoid some avoidable situations.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
4 participants