Skip to content

Commit c53f9af

Browse files
committed
Update installation guide to Qubes OS 4.2.3, add minor improvements
Installation guide has been updated so it reflects the process of installing Qubes OS 4.2.3 as well as some minor improvements, like mentioning the importance of glossary.
1 parent 91849ef commit c53f9af

File tree

1 file changed

+30
-9
lines changed

1 file changed

+30
-9
lines changed

user/downloading-installing-upgrading/installation-guide.md

Lines changed: 30 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,8 @@ title: Installation guide
2323

2424
Welcome to the Qubes OS installation guide! This guide will walk you through the process of installing Qubes. Please read it carefully and thoroughly, as it contains important information for ensuring that your Qubes OS installation is functional and secure.
2525

26+
This guide assumes you're familiar with the [glossary](/doc/Glossary/). Make sure to read it first before moving on.
27+
2628
## Pre-installation
2729

2830
### Hardware requirements
@@ -217,8 +219,12 @@ The new user you create has full administrator privileges and is protected by a
217219
### Installation
218220
When you have completed all the items marked with the warning icon, press **Begin Installation**.
219221

222+
[![Installation summary ready](/attachment/doc/installation-summary-ready.png)](/attachment/doc/installation-summary-ready.png)
223+
220224
Installation can take some time.
225+
221226
[![Windows showing installation complete and Reboot button. ](/attachment/doc/installation-complete-4.2.png)](/attachment/doc/installation-complete-4.2.png)
227+
222228
When the installation is complete, press **Reboot System**. Don't forget to remove the installation medium, or else you may end up seeing the installer boot screen again.
223229

224230
## Post-installation
@@ -238,23 +244,38 @@ Just after this screen, you will be asked to enter your encryption passphrase.
238244
You're almost done. Before you can start using Qubes OS, some configuration is needed.
239245

240246
[![Window with link for final configuration ](/attachment/doc/initial-setup-menu-4.2.png)](/attachment/doc/initial-setup-menu-4.2.png)
247+
241248
Click on the item marked with the warning triangle to enter the configuration screen.
249+
242250
[![Initial configuration menu](/attachment/doc/initial-setup-menu-configuration-4.2.png)](/attachment/doc/initial-setup-menu-configuration-4.2.png)
243251

244252
By default, the installer will create a number of qubes (depending on the options you selected during the installation process). These are designed to give you a more ready-to-use environment from the get-go.
245253

246254
Let's briefly go over the options:
247255

248-
* **Templates Configuration:** Here you can decide which [templates](../templates/) you want to have installed, and which will be the default template.
249-
* **Create default system qubes:** These are the core components of the system, required for things like internet access. You can opt to have some created as [disposables](../glossary#disposable)
250-
* **Create default application qubes:** These are how you compartmentalize your digital life. There's nothing special about the ones the installer creates. They're just suggestions that apply to most people. If you decide you don't want them, you can always delete them later, and you can always create your own.
251-
* **Use a qube to hold all USB controllers:** Just like the network qube for the network stack, the USB qube isolates the USB controllers.
252-
* **Use sys-net qube for both networking and USB devices:** You should select this option if you rely on a USB device for network access, such as a USB modem or a USB Wi-Fi adapter.
253-
* **Create Whonix Gateway and Workstation qubes:** If you want to use [Whonix](https://www.whonix.org/wiki/Qubes), you should select this option.
254-
* **Enabling system and template updates over the Tor anonymity network using Whonix:** If you select this option, then whenever you install or update software in dom0 or a template, the internet traffic will go through Tor.
255-
* **Do not configure anything:** This is for very advanced users only. If you select this option, you will have to manually set up everything.
256+
#### Templates Configuration
257+
258+
This section provides the [templates](/doc/template/) you wish to install and which one to use as the default one. The default template settings can always be changed after this initial configuration too.
259+
260+
#### Main Configuration
261+
262+
* **Create default system qubes (sys-net, sys-firewall, default DispVM):** These are the core components of the system, required for things like internet access.
263+
* **Make sys-firewall and sys-usb disposable:** The qubes responsible for firewalling/isolating network traffic and holding certain hardware devices like USB, Bluetooth adapter, integrated cameras, etc. (**sys-usb** only, if applicable) will be made disposable. Enabled by default as generally there seem to be no benefits for them being persistent anyhow.
264+
* **Make sys-net disposable:** The qube handling your network devices will be made disposable. This will result in loss of remembered Wi-Fi passwords and therefore automatic Wi-Fi connections each time the qube gets booted. Disabled by default for a more user-friendly experience but if you don't mind storing the aforementioned passwords e.g. in an offline database, you may turn it on for privacy enhancements (no broadcasting of saved Wi-Fi network names).
265+
* **Create default application qubes (personal, work, untrusted, vault):** These are how you compartmentalize your digital life. There's nothing special about the ones the installer creates. They're just suggestions that apply to most people. If you decide you don't want them, you can always delete them later, and you can always create your own.
266+
* **Use a qube to hold all USB controllers (create a new qube called sys-usb by default):** A dedicated qube that holds certain hardware devices like USB, Bluetooth adapter, integrated cameras, etc. (**sys-usb**) will be created.
267+
* **Use sys-net qube for both networking and USB devices:** certain hardware devices will be held by **sys-net** instead. You should select this option if you rely on a USB device for network access, such as a USB modem or a USB Wi-Fi adapter, as this option will make the experience with them more user-friendly and seamless.
268+
* **Automatically accept USB mice (discouraged):** If enabled, upon the connecting of a device that presents itself as a USB mouse, it will be automatically forwarded to dom0. Disabled by default so once such device is connected, manual user interaction is required to confirm forwarding that device. This results in additional security benefits - e.g. a malicious device presenting itself as a mouse will be rendered useless until a confirmation dialog in dom0 is accepted.
269+
* **Automatically accept USB keyboard (discouraged if non-USB keyboard is available):** See the point above about USB mice. The same applies here. Enabling this is mostly beneficial to modern stationary workstations where only a USB keyboard can be used for typing. If you can use a PS/2 keyboard (generally laptops use an emulated PS/2 for their internal keyboards), you may want to leave this option disabled for additional security.
270+
* **Create Whonix Gateway and Workstation qubes (sys-whonix, anon-whonix):** If you want to use Whonix, you should select this option.
271+
* **Enable system and template updates over the Tor anonymity network using Whonix:** If you select this option, then whenever you install or update software in dom0 or a template, the internet traffic will go through Tor.
272+
273+
#### Advanced Configuration
274+
275+
* **Use custom storage pool:** Here you can specify custom names for the LVM pool holding your qubes' filesystems as well as LVM Volume Group name. Unless you're preparing a customized environment on your machine (e.g. dual booting distinct Qubes OS releases), you can leave this option unchecked.
276+
* **Do not configure anything (for advanced users):** This is for very advanced users only. If you select this option, you'll have to set everything up manually afterward.
256277

257-
When you're satisfied with your choices, press **Done**. This configuration process may take a while, depending on the speed and compatibility of your system.
278+
When you're satisfied with you choices, press **Done**. This configuration process may take a while, depending on the speed of your computer and the selected options described above (the more templates to be installed, the longer the configuration process will take).
258279

259280
After configuration is done, you will be greeted by the login screen. Enter your password and log in.
260281

0 commit comments

Comments
 (0)