2015-11-29 16:55:20 -05:00
---
2021-03-13 13:06:18 -05:00
lang: en
2015-11-29 16:55:20 -05:00
layout: doc
2021-06-16 22:56:25 -04:00
permalink: /doc/releases/3.1/release-notes/
2021-03-13 13:06:18 -05:00
ref: 16
2021-06-16 02:19:45 -04:00
title: Qubes R3.1 release notes
2015-11-29 16:55:20 -05:00
---
2021-03-13 12:03:23 -05:00
## New features since 3.0
2015-11-29 16:55:20 -05:00
2021-04-10 18:09:05 -04:00
* Management Stack based of Salt Stack in dom0 - [documentation ](/doc/salt/ )
2015-11-29 16:55:20 -05:00
* Out of the box Whonix setup
* UEFI support
2015-12-09 14:34:13 -05:00
* LIVE edition (still alpha, not part of R3.1-rc1)
2015-11-29 16:55:20 -05:00
* Updated GPU drivers in dom0
* Colorful window application icons (instead of just colorful lock icon)
2021-06-17 10:01:53 -04:00
* PV Grub support ([documentation](/doc/managing-vm-kernels/))
2021-04-10 18:09:05 -04:00
* Out of the box USB VM setup, including [handling USB mouse ](https://github.com/QubesOS/qubes-app-linux-input-proxy/blob/master/README.md )
2015-11-29 16:55:20 -05:00
* Xen upgraded to 4.6, for better hardware support (especially Skylake platform)
* Improve updates proxy flexibility - especially repositories served over HTTPS
2021-04-10 18:09:05 -04:00
You can get detailed description in [completed github issues ](https://github.com/QubesOS/qubes-issues/issues?q=is%3Aissue+sort%3Aupdated-desc+milestone%3A%22Release+3.1%22+label%3Arelease-notes+is%3Aclosed )
2015-11-29 16:55:20 -05:00
2021-03-13 12:03:23 -05:00
## Known issues
2015-11-29 16:55:20 -05:00
2015-12-13 13:34:16 -05:00
* Installation image does not fit on DVD, requires either DVD DL, or USB stick (5GB or more)
2015-11-29 16:55:20 -05:00
* Windows Tools: `qvm-block` does not work
* Some icons in the Qubes Manager application might not be drawn correctly when using the Xfce4 environment in Dom0. If this bothers you, please use the KDE environment instead.
2017-05-11 20:12:02 -04:00
* USB mouse (in the case of USB VM) does not work at first system startup (just after completing firstboot). Workaround: restart the system.
2015-12-06 23:25:58 -05:00
2015-11-29 16:55:20 -05:00
* For other known issues take a look at [our tickets ](https://github.com/QubesOS/qubes-issues/issues?q=is%3Aopen+is%3Aissue+milestone%3A%22Release+3.1%22+label%3Abug )
It is advised to install updates just after system installation to apply bug fixes for (some of) the above problems.
2021-03-13 12:03:23 -05:00
## Downloads
2015-11-29 16:55:20 -05:00
See [Qubes Downloads ](/downloads/ ).
2021-03-13 12:03:23 -05:00
## Installation instructions
2015-11-29 16:55:20 -05:00
See [Installation Guide ](/doc/installation-guide/ ).
2021-03-13 12:03:23 -05:00
## Upgrading
2015-11-29 16:55:20 -05:00
### From R3.0
The easiest and safest way to upgrade to Qubes R3.1 is to install it from
scratch and use [qubes backup and restore tools ](/doc/backup-restore/ ) for
migrating of all of the user VMs.
Users of Qubes R3.0 can upgrade using [experimental
procedure](/doc/upgrade-to-r3.1/).
### From R2 or earlier
When upgrading from earlier versions the easiest and safest way is to install
it from scratch and use [qubes backup and restore tools ](/doc/backup-restore/ )
for migrating of all of the user VMs.
Alternatively you can [upgrade to R3.0
using](/doc/releases/3.0/release-notes/#upgrading) first, then follow the
instructions above. This will be time consuming process.
