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.

Sign up for GitHub

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

Reduce Windows confusion in renamed 'Install medium prep' section #1174

Merged
merged 6 commits into from
Jul 14, 2021
Merged

Reduce Windows confusion in renamed 'Install medium prep' section #1174

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
64b1015
Reduce Windows confusion in renamed 'Installation medium preparation'…
dksmiffs Jul 8, 2021
cc8155f
Undo change to 'Copying the ISO' header, not worth the broken links
dksmiffs Jul 11, 2021
d4d00ef
Merge tag 'adw_6eea2bf3'
dksmiffs Jul 11, 2021
4055787
Add clarification based on PR #1174 feedback
dksmiffs Jul 12, 2021
13f7997
Fix link to HTML syntax (#1174)
dksmiffs Jul 12, 2021
4ff7399
Copyedit
andrewdavidwong Jul 13, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 26 additions & 16 deletions user/downloading-installing-upgrading/installation-guide.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,9 @@ under the Advanced tab, you might find them under the Security tab.

### Copying the ISO onto the installation medium

Start by [downloading](/downloads/) a Qubes ISO.
Pick the most secure existing computer and OS you have available for
downloading and copying the Qubes ISO onto the installation medium.
[Download](/downloads/) a Qubes ISO.

<div class="alert alert-danger" role="alert">
<i class="fa fa-exclamation-triangle"></i>
Expand All @@ -80,9 +82,11 @@ Start by [downloading](/downloads/) a Qubes ISO.
</div>

Once the ISO has been verified as authentic, you should copy it onto the
installation medium of your choice, such as a dual-layer DVD, a Blu-ray disc,
or a USB drive. The size of each Qubes ISO is available on the
[downloads](/downloads/) page by hovering over the download button.
installation medium of your choice, such as a USB drive, dual-layer DVD,
or Blu-ray disc. The size of each Qubes ISO is available on the
Comment on lines +85 to +86
Copy link
Member

Choose a reason for hiding this comment

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

Reordered list to put most common and recommended medium first.

[downloads](/downloads/) page by hovering over the download button. The
instructions below assume you've chosen a USB drive as your medium. If you've
chosen a different medium, please adapt the instructions accordingly.

<div class="alert alert-warning" role="alert">
<i class="fa fa-exclamation-circle"></i>
Expand All @@ -97,8 +101,10 @@ or a USB drive. The size of each Qubes ISO is available on the
modifying any devices.
</div>

If you choose to use a USB drive, copy the ISO onto the USB device, e.g. using
`dd`:
#### Linux ISO to USB

On Linux, if you choose to use a USB drive, copy the ISO onto the USB device,
e.g. using `dd`:

```
$ sudo dd if=Qubes-RX-x86_64.iso of=/dev/sdY status=progress bs=1048576 && sync
Expand All @@ -109,29 +115,33 @@ and change `/dev/sdY` to the correct target device e.g., `/dev/sdc`). Make sure
to write to the entire device (e.g., `/dev/sdc`) rather than just a single
partition (e.g., `/dev/sdc1`).

#### Windows ISO to USB

On Windows, you can use the [Rufus](https://rufus.akeo.ie/) tool to write the
ISO to a USB key. MediaTest is not recommended. Be sure to select "DD image"
mode (*after* selecting the Qubes ISO):
ISO to a USB key. Be sure to select "Write in DD Image mode" *after* selecting
the Qubes ISO and pressing "START" on the Rufus main window.

dksmiffs marked this conversation as resolved.
Show resolved Hide resolved
<div class="alert alert-warning" role="alert">
<i class="fa fa-exclamation-circle"></i>
<b>Note:</b> If you do this on Windows 10, you can only install Qubes
without MediaTest, which is not recommended.
<div class="alert alert-info" role="alert">
<i class="fa fa-info-circle"></i>
<b>Note:</b> Using Rufus to create the installation medium means that you
<a href="https://github.com/QubesOS/qubes-issues/issues/2051">won't be able</a>
to choose the "Test this media and install Qubes OS" option mentioned in the
example below. Instead, choose the "Install Qubes OS" option.
</div>

[![Rufus menu](/attachment/doc/rufus-menu.png)](/attachment/doc/rufus-menu.png)

[![Rufus DD image mode](/attachment/doc/rufus-dd-image-mode.png)](/attachment/doc/rufus-dd-image-mode.png)

If you are an advanced user, and you would like to customize your installation,
please see [custom installation](/doc/custom-install/). Otherwise, follow the
instructions below.

## Installation

This section will demonstrate a simple installation using mostly default
settings.

If you are an advanced user, and you would like to customize your installation,
please see [custom installation](/doc/custom-install/). Otherwise, follow the
instructions below.

### Getting to the boot screen

"Booting" is the process of starting your computer. When a computer boots up,
Expand Down