Added recovery steps for common install errors #31
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
eloquence
reviewed
Apr 15, 2020
| @@ -31,6 +31,9 @@ In order to install SecureDrop Workstation and configure it to use an existing S | |||
|
|
|||
| - A Qubes-compatible computer with at least 16GB of RAM (32 GB is recommended). SecureDrop Workstation has mainly been tested against Lenovo 6th-gen T480 and X1 models - see Qubes' `Hardware Compatibility List <https://www.qubes-os.org/hcl/>`_ and the SecureDrop Workstation :doc:`hardware` page for more options . | |||
| - Qubes installation medium - this guide assumes the use of a USB 3.0 stick. Qubes may also be installed via optical media, which may make more sense depending on your `security concerns <https://www.qubes-os.org/doc/install-security/>`_. | |||
|
|
|||
| .. note:: A USB stick with a Type-A connector is recommended, as USB-C ports may be disabled on your computer when the BIOS settings detailed below are applied. | |||
There was a problem hiding this comment.
IMO if we are borking USB-C we should consider if those BIOS settings are too aggressive instead of considering this a standard troubleshooting issue / hardware restriction to carry forward with us indefinitely.
eloquence
reviewed
Apr 15, 2020
| Troubleshooting installation errors | ||
| ----------------------------------- | ||
|
|
||
| "Recurse failed: none of the specified sources were found" |
There was a problem hiding this comment.
Note that this is expected to be resolved by freedomofpress/securedrop-workstation#530 but until that makes its way into a release (and we've verified that the issue no longer occurs) it makes sense to document this.
|
LGTM! I'm fine with merging as-is as it's consistent with our current recommendations but would like to discuss the impact of our BIOS settings more. Will file a separate issue to track. |
eloquence
approved these changes
Apr 15, 2020
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Closes #29
Adds troubleshooting section in installation docs.