Qubes 

Installation

Getting To The Boot Screen

Just after you power on your machine, make the Qubes installation medium available to the computer by inserting your installation medium. Once the computer starts (not boots), keep pressing the key which is used to open the boot menu of your PC, as usual you can find it on the website of the manufacturer of the PC, because it differs from computer to computer.  

Once the boot menu opens, select the installation medium, after selecting the installation medium, the boot screen will appear.  

From here, you can navigate the boot screen using the arrow keys on your keyboard. 

You can choose one of three options:

        • Install Qubes OS
        • Test this media and install Qubes OS
        • Troubleshooting

Select the option to test this media and install Qubes OS.

If the boot screen does not appear, there are several options to troubleshoot. First, try rebooting your computer. If it still loads your currently installed operating system or does not detect your installation medium, make sure the boot order is set up appropriately. You can contact the manufacturer of your PC for learning more about the boot order, as I said that the boot menu totally depends on the manufacturer.  

The Installer Home Screen

On the first screen, you are asked to select the language that will be used during the installation process. When you are done, select  Continue.  

Prior to the next screen, a compatibility test runs to check whether IOMMU-virtualization is active or not. If the test fails, a window will pop up like this:  

Do not panic. It may simply indicate that IOMMU-virtualization hasn’t been activated in the BIOS.. If the setting is not configured correctly, it means that your hardware won’t be able to leverage some Qubes security features, such as a strict isolation of the networking and USB hardware. 

If the test passes, you will reach the installation summary screen. The installer loads Xen right at the beginning. If you can see the installer’s graphical screen, and you pass the compatibility check that runs immediately afterward, Qubes OS is likely to work on your system!  

Installation Summary

The Installation summary screen allows you to change how the system will be installed and configured, including localization settings. 

Localization

Let’s assume you wish to add a German keyboard layout. Go to Keyboard Layout, press the “Plus” symbol, search for “German” as indicated in the screenshot and press “Add”. If you want it be your default language, select the “German” entry in the list and press the arrow button. Click on “Done” in the upper left corner, and you’re ready to go!  

The process to select a new language is similar to the process to select a new keyboard layout. Follow the same process in the “Language Support” entry.    

You can have as many keyboard layout and languages as you want. 

Don’t forget to select your time and date by clicking on the Time & Date entry.  

Software  

On the software selection tab, you can choose which software to install in Qubes OS. 
Two options are available:

        • Debian
        • Whonix

I prefer selecting both, because it will increase the security of Qubes.Press  Done to go back to the installation summary screen.  

Installation Destination  

Under the System section, you must choose the installation destination. Select the storage device on which you would like to install Qubes OS. 

Warning: Be careful to choose the correct installation target, or you may lose data. I strongly recommended making a full backup before proceeding. 

Your installation destination can be an internal or external storage drive, such as an SSD, HDD, or USB drive. The installation destination must have a least 32 GB of free space available. 

Note: The installation destination cannot be the same as the installation medium. For example, if you're installing Qubes OS from a USB drive onto a USB drive, they must be two distinct USB drives, and they must both be plugged into your computer at the same time. 


Installing an operating system onto a USB drive can be a convenient way to try Qubes. However, USB drives are typically much slower than internal SSDs. I recommend you to use a very fast USB 3.0 drive for decent performance. Please note that a minimum storage of 32 GB is required. If you want to install Qubes OS onto a USB drive, just select the USB device as the target installation device. Keep in mind that the installation process is likely to take longer than it would on an internal storage device.  

As soon as you press Done, the installer will ask you to enter a passphrase for disk encryption. The passphrase should be complex. Make sure that your keyboard layout reflects what keyboard you are actually using. When you’re finished, press Done. 

Warning: If you forget your encryption passphrase, there is no way to recover it.  

When you’re ready, press  Begin Installation.  

Create Your User Account

While the installation process is running, you can create your user account. This is what you’ll use to log in after disk decryption and when unlocking the screen locker. This is a purely local, offline account in dom0. By design, Qubes OS is a single-user operating system, so this is just for you. 

Select User Creation to define a new user with administrator privileges and a password. Just as for the disk encryption, this password should be complex. The root account is deactivated and it should remain as such.  

When the installation is complete, press Reboot. Don’t forget to remove the installation medium, or else you may end up seeing the installer boot screen again.  

BACK TO TABLE OF CONTENTS

Widgets: 

        • The Domains Widget allows you to manage running qubes, turn them on and off, and monitor memory usage.
        • The Devices Widget allows you to attach and detach devices – such as USB drives and cameras – to qubes.
        • The Disk Space Widget will notify you if you’re ever running out of disk space.
        • The Updates Widget will inform you when template updates are available.

For an overview of the entire system, you can use the Qube Manager (go to the Application Launcher → System Tools → Qube Manager), which displays the states of all the qubes in your system.  

BACK TO TABLE OF CONTENTS

Device Handling:

The interface to deal with devices of all sorts is the tool tray icon with a yellow square (        ) located in the top right of your screen by default. 

There are currently four categories of devices Qubes understands:

        • Microphones
        • Block devices
        • USB devices
        • PCI devices

Microphones, block devices and USB devices can be attached with the GUI-tool. PCI devices can be attached using the Qube Settings, but they require a VM reboot.  

General Qubes Device Widget Behaviour And Handling:

When clicking on the tray icon (      ): several device-classes separated by lines are displayed as tooltip. Block devices are displayed on top, microphones one below and USB-devices at the bottom.  

On most laptops, integrated hardware such as cameras and fingerprint-readers are implemented as USB-devices and can be found here.  

Attaching Devices Using The Widget:

Click on the tray icon. Hover on a device you want to attach to a VM. A list of running VMs (except dom0) appears. Click on one and your device will be attached!  

Detaching Devices Using The Widget:

To detach a device, click the tray icon again. Attached devices are displayed in bold. Hover the one you want to detach. A list of VMs appears, click on the one showing the eject symbol (      ).

BACK TO TABLE OF CONTENTS

Installing Software On Specific Domains:

Installing softwares on qubes is a very complex process, so to make it easy for everyone, I have written a step-by-step guide which can help you install software on specific domains.

Follow the steps below to install software on specific domains:


1) To install a software on a specific domain, we will install the software on the Template VM of the qube first, and then the specific domain will have the software automatically installed in it. For instance, if we want to install a software on the “Work” domain, then we will install the software on the Fedora-30 Template first, because “Work” domain is based on Fedora-30. 

2) For the first time, we will need to enable internet access in the Template VM, to do so, open the “Qube Settings” of the Template VM. 

3) Change the NetVM from “None” to “sys-net”. 

4) Click “OK” to save the settings. 

5) Now we will install the software on the Template VM. 

6) Go to Applications > [Template VM] > Software . 

7) Search for the software, and then install it. 

8) Once the software has been installed, shut down the Template VM, because it is necessary to shutdown the Template VM to implement the changes. 

9) Now we are ready to use the installed software on the VMs based on the Template, on which we have installed the software. But the problem is that we aren’t able to access the program directly from the Application Menu, to do so : 

10) Open the “Qube Settings” of the VM on which you want to use the software. 

11) Go to the “Applications” tab in the settings of the VM. 

12) Click “Refresh Applications”. 

13) On the left side of the screen, you will be able to see the list of programs installed on the VM, and on the right side of the screen, you will be able to see the list of programs visible in the Applications Menu. 

14) Select the installed program from the “Available” tab. 

15) Click on the “>” icon. 























16) Click “OK” to save the settings. 

17) Done, now you will be able to access the program from the Applications Menu of the VM. 

Keep in mind that you should only install a safe software in the Template VM, because if the Template VM gets infected, then all the VMs based on it, will also be infected.  

BACK TO TABLE OF CONTENTS

Installing Software On Whonix Based Domains:

Installing software on a Whonix based qube is quite different, because there isn’t a GUI which allows us to install a software, instead, we can use the terminal to install software on a Whonix based system.    

Follow the steps below to install a software on a Whonix based qube:

1) Open the Xfce Terminal of “Template : Whonix-ws-15”. 

2) First we will update the list of applications/software available, to do so, run “sudo apt-get update”. This will update the list of software available. “Sudo” is a command which giv​es us administrator privileges in the terminal. 

3) Now we will search for the application, to do so, run “sudo apt-cache search [application name / service / tool]”. Now it will list all the software related to the search. Copy the name of the software/package you want to install. 



















4) Now we are going to install the software, to do so, run “sudo apt-get install [application name/package name]”. It might ask you for a confirmation, type “y” and then press [ENTER] to confirm it. Now the software/package has been installed. 




5) Now we are ready to use the installed software on the Whonix VM. But the problem is that we aren’t able to access the program directly from the Application Menu, to do so : 

6) Open the “Qube Settings” of the Whonix VM. 

7) Go to the “Applications” tab in the settings of the Whonix VM. 

8) Click “Refresh Applications”. 

9) On the left side of the screen, you will be able to see the list of programs installed on the VM, and on the right side of the screen, you will be able to see the list of programs visible in the Applications Menu. 

10) Select the installed program from the “Available” tab. 

11) Click on the “>” icon. 























12) Click “OK” to save the settings. 

13) Done, now you will be able to access the program from the Applications Menu of the Whonix VM.     

Keep in mind that you should only install a safe software in the Template VM, because if the Template VM gets infected, then all the VMs based on it, will also be infected.  

BACK TO TABLE OF CONTENTS

Updating Template VMs:

Updating Template VMs is a very crucial part of Qubes OS, because if the Template VM is outdated then it will affect all the AppVMs based on it.

Follow the steps below to update a template VM:

1) Open qubes manager.
2) Right click on the Template VM. 
3) Select “Update Qube”. 
4) Now it will start the Template VM, and it will also the start the updating procedure of the Template VM. 
5) In between the update it might ask you for a confirmation, type “y” and then press [ENTER] to confirm it.


















6) Once the installation is complete, shut down the Template VM. 
7) Now the Template VM has been updated, and we are ready to use the AppVMs based on it.  


Note: Keep updating the Template VM from time-to-time.

BACK TO TABLE OF CONTENTS